curl --request GET \
--url 'https://api.voice.stateset.com/api/v1/customer/numbers/search' \
--header "Authorization: Bearer $STATESET_VOICE_API_KEY"
{
"ok": true,
"numbers": [
{
"phone_number": "+14155551234",
"locality": "San Francisco",
"region": "CA"
}
]
}
Search
StateSet Voice API operation.
GET
/
api
/
v1
/
customer
/
numbers
/
search
curl --request GET \
--url 'https://api.voice.stateset.com/api/v1/customer/numbers/search' \
--header "Authorization: Bearer $STATESET_VOICE_API_KEY"
{
"ok": true,
"numbers": [
{
"phone_number": "+14155551234",
"locality": "San Francisco",
"region": "CA"
}
]
}
StateSet Voice API operation.
Query parameters
string
required
3-digit US area code to search for available Twilio numbers
Response
object
boolean
required
object[]
required
Status codes
| Code | Meaning |
|---|---|
200 | Available phone numbers matching the requested area code |
400 | area_code must be 3 digits |
402 | Payment method required |
404 | Number provisioning disabled or customer self-serve plane disabled |
502 | Number provider (Twilio) error |
curl --request GET \
--url 'https://api.voice.stateset.com/api/v1/customer/numbers/search' \
--header "Authorization: Bearer $STATESET_VOICE_API_KEY"
{
"ok": true,
"numbers": [
{
"phone_number": "+14155551234",
"locality": "San Francisco",
"region": "CA"
}
]
}
Last modified on August 31, 2026