Skip to main content
GET
/
v1
/
organization
/
phone-numbers
/
available
cURL
curl --request GET \
  --url https://api.buildwithchirp.com/v1/organization/phone-numbers/available \
  --header 'Authorization: Bearer <token>'
{
  "phoneNumbers": [
    {
      "phoneNumber": "+14155551234",
      "location": "San Francisco, CA",
      "country": "US",
      "numberType": "local",
      "features": [
        "SMS",
        "MMS",
        "Voice"
      ],
      "activationPrice": "1.00",
      "monthlyPrice": "1.50"
    }
  ],
  "totalCount": 123
}

Authorizations

​
Authorization
string
header
required

Admin API key (format: sk_admin_*) for organization-level operations

Query Parameters

​
country
string

Filter by country code (e.g., US, CA, GB)

Example:

"US"

​
areaCode
string

Filter by area code

Example:

"415"

​
contains
string

Filter by numbers containing specific digits

Example:

"555"

​
limit
string

Number of results to return (default: 20)

Example:

"20"

Response

List of available phone numbers

​
phoneNumbers
object[]
required
​
totalCount
number
required