Skip to main content
POST
/
v1.0
/
numbers
/
availability
json
{
  "NumberType": "mobile",
  "MessageType": "p2p",
  "MessageEnabled": true,
  "VoiceEnabled": true,
  "PageNumber": 1,
  "AreaCode": "201",
  "ZipCode": ""
}
{
  "RequestId": "T-04139",
  "RequestDate": "2025-05-14T18:37:18.2408767Z",
  "NumberType": "mobile",
  "VoiceEnabled": true,
  "MessageEnabled": true,
  "AreaCode": "201",
  "ZipCode": "",
  "PageNumber": 1,
  "ResultsTotal": 7700,
  "AvailableNumberAreas": [
    {
      "NGP": "SAG",
      "AreaCode": 993,
      "Zipcode": "00601"
    },
    {
      "NGP": "AGP",
      "AreaCode": 787,
      "Zipcode": "00601"
    }
  ]
}

Body

application/json
​
NumberType
enum<string>
required

Type of number to search for

Available options:
mobile
Example:

"mobile"

​
MessageEnabled
boolean
required

Enable SMS/MMS capabilities

Example:

true

​
VoiceEnabled
boolean
required

Enable voice call capabilities

Example:

true

​
MessageType
enum<string>

Message type: a2p (Application-to-Person) or p2p (Person-to-Person)

Available options:
a2p,
p2p
Example:

"p2p"

​
PageNumber
integer
default:1

Page number for pagination (10,000 results per page)

Example:

1

​
AreaCode
string

3-digit area code to search (leave empty for all area codes)

Example:

"201"

​
ZipCode
string

Zip code to search if area code is unavailable

Example:

""

Response

Success — returns a paginated list of available phone numbers matching your criteria

The response is of type object.