curl -X POST "https://api.nedzo.ai/v1/phone-numbers/search" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "countryCode": "US", "areaCode": "415", "limit": 5 }'
{
"items": [
{
"phoneNumber": "+14155551234",
"nationalFormat": "(415) 555-1234",
"region": { "city": "San Francisco", "state": "CA" },
"monthlyPriceCents": 99
}
],
"total": 1
}
Phone Numbers
Search numbers
Find local US and Canada numbers you can buy, with the monthly price.
POST
/
phone-numbers
/
search
curl -X POST "https://api.nedzo.ai/v1/phone-numbers/search" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "countryCode": "US", "areaCode": "415", "limit": 5 }'
{
"items": [
{
"phoneNumber": "+14155551234",
"nationalFormat": "(415) 555-1234",
"region": { "city": "San Francisco", "state": "CA" },
"monthlyPriceCents": 99
}
],
"total": 1
}
This endpoint is for the VIP plan only. Other plans get a
403. See Plan access.string
default:"US"
US or CA.string
A 3-digit area code, for example
415.string
Digits the number must contain, up to 10.
integer
default:"10"
How many numbers to return, 1 to 100.
curl -X POST "https://api.nedzo.ai/v1/phone-numbers/search" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "countryCode": "US", "areaCode": "415", "limit": 5 }'
{
"items": [
{
"phoneNumber": "+14155551234",
"nationalFormat": "(415) 555-1234",
"region": { "city": "San Francisco", "state": "CA" },
"monthlyPriceCents": 99
}
],
"total": 1
}
Errors
| Status | When |
|---|---|
400 | A field is not valid |
502 | The phone number service did not answer. Try again |
Was this page helpful?