Search Phone Numbers

Search available phone numbers to purchase for a country. Returns up to 20 numbers per request in E.164 format. Use a result from this endpoint with Buy Phone Number.

Endpoint

POST https://www.tabbly.io/api/phone-numbers/search

Authentication

See Introduction. This is a POST endpoint — include api_key in the JSON request body.

Request body

Field	Type	Required	Description
`api_key`	string	Yes	Your organization API key
`country`	string	Yes	ISO country code (e.g. `IN`, `US`)
`country_code`	string	No	Alias for `country` (same meaning; `country` is used if both are sent)

Example request

curl -X POST "https://www.tabbly.io/api/phone-numbers/search" \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "YOUR_API_KEY",
    "country": "IN"
  }'

Response

Success (200)

{
  "success": true,
  "country": "IN",
  "count": 20,
  "phone_numbers": [
    "+912269858803",
    "+912269852098"
  ]
}

Error responses

{
  "success": false,
  "error": "Human-readable error description"
}

HTTP status	When	Example `error`
400	Missing or invalid input	`API key is required`, `country is required`
401	Invalid API key	`Invalid API key`
405	Not POST	`Method not allowed`

Supported countries

US, GB, AU, CA, DE, JP, BR, MX, FR, IN, IT, ES, NL, BE, SE, CH, DK, NO, FI, AT, IE, PT, PL, IL, ZA, AR, CL, PR, SG, MY, PH, TH, NZ