Search Phone Numbers

Finds available phone numbers you can buy for a country. Returns numbers in E.164 format. For India (IN), results come from Tabbly available inventory (optionally filtered by area code). 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

Parameter	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`. Use either field; if both are sent, `country` is used
`area_code`	string	No	Optional India STD filter (e.g. `80`, `22`). Alias: `pattern`

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

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": 2,
  "phone_numbers": [
    "+918065830105",
    "+912269858803"
  ],
  "phone_number_details": [
    {
      "phone_number": "+918065830105",
      "price": "5.00"
    },
    {
      "phone_number": "+912269858803",
      "price": "5.00"
    }
  ]
}

Field	Description
`phone_numbers`	Flat E.164 list of available numbers
`phone_number_details`	Same numbers with list `price`

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`