Skip to main content
GET
/
available-numbers
Search Available Phone Numbers
curl --request GET \
  --url https://api.kallabot.com/available-numbers \
  --header 'Authorization: Bearer <token>'
{
  "available_phone_numbers": [
    {
      "friendly_name": "(415) 555-1234",
      "phone_number": "+14155551234",
      "lata": "722",
      "locality": "San Francisco",
      "rate_center": "SNFC CNTRL",
      "latitude": "37.7749",
      "longitude": "-122.4194",
      "region": "CA",
      "postal_code": "94102",
      "iso_country": "US",
      "capabilities": {
        "voice": true,
        "sms": true,
        "mms": true
      }
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
country
string
default:US

Country code (ISO 3166-1 alpha-2)

​
number_type
enum<string>
default:local

Type of phone number to search for

Available options:
local,
mobile,
toll-free,
national
​
area_code
string

Area code to search within (US/Canada only)

​
limit
integer
default:20

Number of results to return

Required range: x <= 50

Response

List of available phone numbers

​
available_phone_numbers
object[]
required