Phone numbers
List available phone numbers
Browse purchasable phone numbers from Surge inventory before buying.
Pagination cursors are always null for now.
get/accounts/{account_id}/available_phone_numbers
Path parameters
account_idstring required
The account ID to list available phone numbers for.
Example:acct_01j9a43avnfqzbjfch6pygv1td
Query parameters
area_codestring
Filter by 3-digit area code.
Example:801
country'US' | 'CA'
ISO country code to search in.
Example:US
type'local' | 'toll_free' required
Whether to search for local or toll-free numbers.
Example:local
afterstring
Cursor for forward pagination. Use the next_cursor from a previous response.
beforestring
Cursor for backward pagination. Use the previous_cursor from a previous response.
Response
List of available phone numbers
Example response
{
"data": [
{
"country": "US",
"number": "+18015551234",
"type": "local"
}
],
"pagination": {
"next_cursor": null,
"previous_cursor": null
}
}