List Numbers

Returns phone-number assignments for the API key user. Provider tokens and ownership internals are never returned.

Request

Endpoint

GET/api/v1/numbers

Authentication

x-api-keyorAuthorization: Bearer

Response Example

response.json

{
  "success": true,
  "data": [
    {
      "phone_number": "+919876543210",
      "provider": "Exotel",
      "status": "live",
      "country_code": "+91",
      "country_name": "India",
      "is_international": false,
      "assigned_to": {
        "assistant_id": "66aa2b3c4d5e6f7a8b9c0d11",
        "assistant_name": "Sales Bot"
      }
    }
  ]
}

Status Codes

HTTP	Meaning	Description
200	OK	Request succeeded.
401	Unauthorized	Missing, invalid, inactive, or origin-restricted API key.
429	Rate limited	Per-IP or per-key request budget was exceeded.

Security Model

User-scoped by default

This endpoint only sees resources owned by the user attached to the API key. If another user's id is supplied, the API responds as if the resource does not exist.