The user can purchase a phone number. Number endpoints are meant for querying available phone numbers. To purchase phone numbers, the sender endpoints are used.

Method: Query

List available numbers for purchase.

URL /v1/numbers
Method Type GET
Authorization API Key
Request Content-Type JSON
Response Content-Type JSON


Name Type Description Status
X-Dexatel-Key string API key Required

Query parameters

Name Type Description Status
type string Type of the number (Local - Mobile - Toll-free - Alphanumeric - Short-code) Required
country string Country ISO code of the number Required
city string City of the number, in case the type is local Optional

Request Body


Response Parameters

Name Type Description
data array


(see data object below)
data object
Name Type Description
number string Filtered phone number
type string Filters phone numbers by type
country string ISO country code
city string Name of the city
setup_cost number Setup price for acquiring the number
monthly_cost number Monthly price for acquiring the number

Example of request body

GET: /v1/numbers
X-Dexatel-Key: 94d2f2f2884848bca861264ad86d8ace

Example of response body

status - 200


Error Codes

The following error codes are returned in response to a user’s request which contains bad syntax or cannot be fulfilled.

Code Description
1411 Invalid number type specified
1412 Invalid country iso code