Network operations staffed around the clock
Skyroute
EN · EnglishEN
Talk to salesRequest access
DEVELOPERS / API

Build on measurable routes.

Use a scoped API key from your account. Requests use Bearer authentication and return JSON. Start with the marketplace, then submit traffic using approved IDs.

API REFERENCE

Core endpoints.

Use https://129.146.81.159/api/v1 for this site. The API Keys page creates scoped Bearer keys. EUR prices appear after rate conversion; IDs and wallet balances depend on your account.

AUTHENTICATION

Bearer key and scopes

Set the Authorization header on each request. A missing or revoked key returns 401; a key without the required scope returns 403. API keys are shown in full only when created.

REQUEST HEADER
Authorization: Bearer YOUR_API_KEY
GET /api/v1/marketplace

Route marketplace

Requires marketplace:read. Filter by destination, operator and a 1h, 24h or 7d window. Customer responses contain route aliases and customer prices, without carrier identity.

REQUEST
GET /api/v1/marketplace?destination=India&operator=Airtel&window=24h
200 RESPONSE · EXAMPLE SHAPE
{
  "selection": {"destination":"India","operator":"Airtel","window":"24h"},
  "filters": {"destinations":["India"],"operators":["Airtel"],"windows":["1h","24h","7d"]},
  "routes": [{"alias":"R-07","label":"Priority","price":0.188,"delivery_rate":96,
    "speed_ms":1200,"sample_count":420,"cost_per_delivered":0.19583,
    "state":"shown","best_value":true,"insufficient_data":false}],
  "route_policy": {"source":"unassigned_default","rule_id":null,"mode":"auto","default_route":null},
  "auto_route": true
}
POST /api/v1/sms/send

Send SMS

Requires sms:send, an approved sender ID, a plan, enough wallet funds and a unique idempotency key. Reuse the key only to retry the same send; a changed request with the same key returns 409. The request creates a local queued or scheduled batch. Carrier delivery requires a connected provider; this response is not a delivery receipt.

JSON REQUEST BODY
{
  "idempotency_key": "11111111-1111-4111-8111-111111111111",
  "to": ["+919812345670"],
  "message": "Your code is 448120",
  "sender_id": "SKYOTP",
  "route": "auto",
  "destination": "India",
  "operator": "Airtel"
}
201 RESPONSE · EXAMPLE SHAPE
{
  "batch_id": "SMS-EXAMPLE123",
  "status": "queued",
  "route": "R-07",
  "recipients": 1,
  "segments": 1,
  "route_selection_source": "unassigned_default",
  "route_assignment_source": "unassigned_default",
  "route_assignment_rule_id": null,
  "cost": 0.19,
  "currency": "EUR",
  "wallet_balance": 4819.81,
  "message": "Queued locally. Delivery requires a connected carrier."
}
POST /api/v1/voip/call

Voice preflight

Requires voip:call, an approved caller ID, an active plan, funds and a secure SIP WebSocket endpoint. A successful response authorizes the connected SIP browser phone to place a call; this request alone does not dial.

JSON REQUEST BODY
{
  "to": "+442079460102",
  "caller_id": "+15550001111"
}
200 RESPONSE · EXAMPLE SHAPE
{
  "authorized": true,
  "to": "+442079460102",
  "caller_id": "+15550001111",
  "route_alias": "V-01",
  "selection_source": "unassigned_default",
  "message": "Preflight passed. Place the call through the connected SIP.js browser phone."
}
ERROR STATES

Handle a reason, then retry.

401 means the key is missing or revoked; 403 means the key lacks the required scope or the account is suspended. 402 asks for a plan or wallet top-up. 422 carries field validation or policy errors; 503 means a required service is unavailable.

401 RESPONSE · EXACT EXAMPLE
{"message":"Bearer API key required."}