Skip to main content
GET
/
v1
/
channels
/
phone-numbers
/
search
Search available phone numbers
curl --request GET \
  --url https://api.cuadra.ai/v1/channels/phone-numbers/search \
  --header 'Authorization: Bearer <token>'
{
  "items": [
    {
      "phoneNumber": "<string>",
      "friendlyName": "<string>",
      "countryCode": "<string>",
      "numberType": "<string>",
      "capabilities": [
        "<string>"
      ],
      "monthlyCostCents": 123,
      "region": "<string>",
      "locality": "<string>"
    }
  ],
  "nextCursor": "<string>",
  "hasMore": false
}

Authorizations

Authorization
string
header
required

JWT token from Stytch B2B authentication (magic link, SSO, or M2M)

Query Parameters

countryCode
string
required

ISO country code (e.g., US, ES, GB)

region
string | null
areaCode
string | null
contains
string | null
numberType
string
default:local
limit
integer
default:20
Required range: 1 <= x <= 50

Response

Successful Response

Response schema for available phone number list.

items
AvailableNumberOut · object[]
required
nextCursor
string | null
hasMore
boolean
default:false