API Reference
Numbers

Search the inventory for available DIDs

GET
/v1/numbers/available

Authorization

bearerAuth
AuthorizationBearer <token>

Long-lived ES256 JWT minted from the dashboard (https://app.sautikit.com/developers/api-keys). Signed by the platform keyring. Carries workspace_id and scopes claims; revoked via the platform deny-list.

In: header

Query Parameters

country?string
capability?array<>
limit?integer
Range1 <= value <= 200

Response Body

application/json

application/json

curl -X GET "https://example.com/v1/numbers/available"
{  "available": [    {      "inventory_id": "33b46487-a064-4390-820a-0d9c2a9fa4e7",      "e164": "string",      "country": "string",      "capabilities": [        "voice"      ],      "monthly_price_minor": 0,      "currency": "string",      "inbound_per_min_minor": 0,      "outbound_per_min_minor": 0    }  ],  "next_cursor": "string"}
{  "error": {    "code": "validation.bad_request",    "message": "string",    "request_id": "string"  }}

List numbers assigned to the active workspace GET

Previous Page

Claim an available inventory DID into the workspace POST

Server-side proration debits the workspace wallet for the remainder of the current billing month. Idempotency via the `Idempotency-Key` header (preferred) — the body's `idempotency_key` field is accepted for backwards compatibility but deprecated. If both are supplied, the header wins.