ConduitInfrastructure
Developer Reference

APIReference&IntegrationGuide

Authenticate via Bearer API keys, invoke standardized endpoints, and receive structured JSON responses. Test any endpoint below.

Postman CollectionFull Docs Workspace

Authentication Header

Every request must include your client's API key in the Authorization header using the Bearer scheme:

Authorization: Bearer cnd_live_9b4e1837f4820a1c...Required

Core API Endpoints

POST/v1/send-template

Dispatch pre-approved WhatsApp Business templates with variables.

Request Example (cURL)
curl -X POST "https://api.conduit.internal/v1/send-template" \
  -H "Authorization: Bearer cnd_live_9b4e1837f4820a1c" \
  -H "Content-Type: application/json" \
  -d '{
    "template_key": "order_confirmation",
    "phone": "+919876543210",
    "variables": {
      "order_id": "ORD-8921",
      "eta": "Tomorrow, 4 PM"
    }
  }'
Response (HTTP 200 OK)
{
  "status": "success",
  "message_id": "wamid.HBgLOTE4ODIzNDkxMDIw",
  "provider_status": "SENT",
  "latency_ms": 42
}
POST/v1/otp/send

Generate and dispatch a cryptographic 6-digit verification code.

Request Example (cURL)
curl -X POST "https://api.conduit.internal/v1/otp/send" \
  -H "Authorization: Bearer cnd_live_9b4e1837f4820a1c" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "+919876543210",
    "template_key": "auth_otp"
  }'
Response (HTTP 200 OK)
{
  "status": "success",
  "otp_id": "otp_req_38f921a",
  "expires_in_seconds": 600
}
POST/v1/otp/verify

Validate user-submitted code against active challenge session.

Request Example (cURL)
curl -X POST "https://api.conduit.internal/v1/otp/verify" \
  -H "Authorization: Bearer cnd_live_9b4e1837f4820a1c" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "+919876543210",
    "code": "849201"
  }'
Response (HTTP 200 OK)
{
  "status": "verified",
  "valid": true
}
GET/v1/status

Retrieve operational connection and provider session status.

Request Example (cURL)
curl -X GET "https://api.conduit.internal/v1/status" \
  -H "Authorization: Bearer cnd_live_9b4e1837f4820a1c"
Response (HTTP 200 OK)
{
  "status": "HEALTHY",
  "provider_connected": true,
  "average_latency_ms": 45
}

Postman API Collection

Download the complete pre-configured Postman collection with variables for local and production testing.

Download Postman File