Buy
List available phone numbers
Returns a paginated list of phone numbers available for purchase in the specified city.
get/v1/buy/countries/{country_id}/cities/{city_id}/dids
Path parameters
country_idinteger required
The unique ID of the country.
city_idinteger required
The unique ID of the city.
Query parameters
text_enabled_onlyboolean
When true, returns only text-enabled phone numbers.
pageinteger
Page number to retrieve. Default 1.
per_pageinteger
Number of records to return per page. Default 25.
Response
Returns a paginated list of available phone numbers.
Example response
{
"dids": [
{
"activation_fee": "15.0",
"channels": "4",
"city": "Buenos Aires",
"cnam": false,
"country": "Argentina",
"country_short_name": "AR",
"domestic_cli": false,
"free_min": 0,
"id": 541139862174,
"monthly_fee": "10.0",
"number": "541139862174",
"per_min": "0.01",
"require_docs": [],
"sms_enabled": false,
"sms_price": 0
}
],
"pagination": {
"total": 1,
"total_pages": 1,
"current_page": 1,
"per_page": 50
}
}