# Sendexa API

> Sendexa provides communication, verification, and identity APIs.
> All REST products share a single base URL and Basic Auth scheme.

## Authentication

  Authorization: Basic <base64(apiKey:apiSecret)>

Dashboard → Settings → API Keys.

## Base URL

  https://api.sendexa.co

All REST endpoints are under /v1/.

## Communication APIs

### SMS
- POST /v1/sms/send
- POST /v1/sms/bulk
- GET  /v1/sms/status/:id
- POST /v1/sms/resend/:id
Docs: /docs/sms

### Email
- POST /v1/email/send | /v1/email/bulk
- GET  /v1/email/status/:id
Docs: /docs/email

### WhatsApp
- POST /v1/whatsapp/send
- GET  /v1/whatsapp/status/:id
Docs: /docs/whatsapp

### Voice
- POST /v1/voice/call | /v1/voice/agents | /v1/voice/tts | /v1/voice/play
Docs: /docs/voice

### Live Chat
Docs: /docs/chat

### USSD
- POST /v1/ussd/session
Docs: /docs/ussd

### Live Video (preview)
Interactive rooms (WebRTC):
- POST /v1/video/rooms
- GET  /v1/video/rooms/:roomId
- POST /v1/video/rooms/:roomId/tokens
- POST /v1/video/rooms/:roomId/end
- POST /v1/video/rooms/:roomId/egress/live  (simulcast room → stream)
Live streaming (broadcast):
- POST /v1/video/streams
- GET  /v1/video/streams/:streamId
- POST /v1/video/streams/:streamId/end
- POST /v1/video/streams/:streamId/playback-tokens
- Ingest: RTMP/RTMPS + SRT · Playback: HLS + LL-HLS
Docs: /docs/video · /docs/video/streaming

### RCS Business Messaging (preview)
- POST /v1/rcs/send
- GET  /v1/rcs/status/:messageId
- SMS fallback when RCS unavailable
Docs: /docs/rcs

### In-App Chat SDK (preview)
- POST /v1/chat-sdk/users/token
- POST /v1/chat-sdk/channels
- POST /v1/chat-sdk/channels/:id/messages
- GET  /v1/chat-sdk/channels/:id/messages
- Client: @sendexa/chat-sdk
Docs: /docs/chat-sdk

### SIP Trunking (preview)
- SIP: sip.sendexa.co:5060 (UDP/TCP), :5061 (TLS)
- POST /v1/sip/trunks | GET /v1/sip/trunks
- POST /v1/sip/numbers | GET /v1/sip/cdr
Docs: /docs/sip-trunking

### Mobile Push (preview)
- POST /v1/push/devices
- DELETE /v1/push/devices/:token
- POST /v1/push/send
- POST /v1/push/topics/subscribe
Docs: /docs/mobile-push

### ExaLink (preview)
- POST /v1/exalink/links
- GET|PATCH|DELETE /v1/exalink/links/:id
- GET /v1/exalink/links/:id/analytics
Docs: /docs/exalink

## Verification & Identity

### Verify (OTP)
- POST /v1/otp/request | /v1/otp/verify | /v1/otp/resend/:id
Docs: /docs/verify

### Identity (KYC)
- POST /v1/identity/ghana-card | /voter-id | /msisdn-name | /mobile-money | /bank-account
- GET  /v1/identity/checks | /v1/identity/checks/:checkId
- POST /v1/verify/sessions | GET /v1/verify/sessions/:sessionId  (hosted ID + liveness)
Docs: /docs/identity

### Fraud Guard
- POST /v1/fraud/risk/assess
Docs: /docs/fraud-detection

### Number Lookup / HLR (preview)
- POST /v1/lookup
- POST /v1/lookup/bulk
Docs: /docs/number-lookup

## Platform

### SMPP
  Host: smpp.sendexa.co:2775 · SMPP v3.4
Docs: /docs/smpp

### Webhooks
HMAC-SHA256 via X-Sendexa-Signature.
Docs: /docs/webhooks

## Docs

https://docs.sendexa.co
Dashboard: https://dash.sendexa.co