SMAO API Documentation
Public APIAssistants

List purchased phone numbers for new assistants

GET
/phone-numbers

Returns the purchased phone numbers your organization can give a new assistant: numbers your instance allocated to the organization that no assistant uses yet. Send a number's id as phone_number_id when creating an assistant. The list is empty when the organization has none; creating an assistant without phone_number_id then allocates a number automatically. Ordered by number.

Authorization

bearerAuth
AuthorizationBearer <token>

API key in the Authorization: Bearer <key> header. Keys are created in the SMAO dashboard (Settings → API Keys).

In: header

Query Parameters

cursor?string

Opaque cursor from a prior meta.next_cursor. Base64url-encoded (unpadded) - do not parse or construct it manually.

Match^[A-Za-z0-9_-]+$
limit?integer

Items per page (1–100, default 50).

Range1 <= value <= 100
Default50

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/phone-numbers"
{  "data": [    {      "id": "string",      "phone_number": "string",      "account_label": "string"    }  ],  "meta": {    "has_more": true,    "next_cursor": "string"  }}