A

AfriRoute

Developer Portal

public api
Sign in
API Explorer

Test a real live-spec SMS flow before wiring your backend

The explorer is aligned to the curated external contract for POST /api/v1/sms/send. It shows the public request shape developers need while keeping internal routing, credentials, and infrastructure details outside the docs surface.

POST /api/v1/sms/send

Try the live SMS request shape

preview only
Request and response preview
This explorer uses the same SMS sample shown in the public OpenAPI and Postman assets, focused on the request and response shape developers need.
{
  "endpoint": "/api/v1/sms/send",
  "headers": {
    "Authorization": "YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  "request": {
    "to": "+251900000000",
    "message": "Your OTP code is 123456",
    "country": "ET",
    "senderId": "AFRIROUTE",
    "type": "otp",
    "webhookUrl": "https://example.com/webhooks/afriroute",
    "metadata": {
      "source": "developer-portal",
      "journey": "quickstart"
    }
  },
  "response": {
    "messageId": "sms_01JPFZ0D4PT4X6YQ8ZZ8E1KS8R",
    "status": "queued",
    "to": "+251900000000",
    "from": "AFRIROUTE",
    "messageCount": 1,
    "segments": 1,
    "operator": "ethio-telecom",
    "cost": 0.032,
    "currency": "USD",
    "remainingBalance": 42.768,
    "routingReason": "AI-selected best route for ET OTP traffic",
    "createdAt": "2026-03-08T11:36:00Z",
    "submittedAt": "2026-03-08T11:36:03Z",
    "operatorUsed": "ethio-telecom",
    "estimatedCost": 0.032,
    "estimatedDeliveryTime": 4
  }
}