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.
Authorization: Bearer YOUR_API_KEYUse a scoped API key from your account. Requests use Bearer authentication and return JSON. Start with the marketplace, then submit traffic using approved IDs.
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.
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.
Authorization: Bearer YOUR_API_KEYRequires marketplace:read. Filter by destination, operator and a 1h, 24h or 7d window. Customer responses contain route aliases and customer prices, without carrier identity.
GET /api/v1/marketplace?destination=India&operator=Airtel&window=24h{
"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
}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.
{
"idempotency_key": "11111111-1111-4111-8111-111111111111",
"to": ["+919812345670"],
"message": "Your code is 448120",
"sender_id": "SKYOTP",
"route": "auto",
"destination": "India",
"operator": "Airtel"
}{
"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."
}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.
{
"to": "+442079460102",
"caller_id": "+15550001111"
}{
"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."
}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.
{"message":"Bearer API key required."}