curl -X GET "https://api.wirebox.sh/api/v1/phone/numbers?limit=50" \
-H "Authorization: Bearer $WIREBOX_API_KEY"
{
"numbers": [
{
"id": "pn_01J8ABC123DEF456",
"phone_number": "+14155550123",
"country_code": "US",
"type": "local",
"region": "CA",
"agent_handle": "eva",
"agent_identity_id": "agt_01J8ABC123DEF456",
"status": "active",
"sms_status": "ready",
"sms_error_code": null,
"sms_error_detail": null,
"sms_ready_at": "2026-09-14T10:12:30Z",
"capabilities": { "sms": true, "mms": true, "voice": false },
"created_at": "2026-09-14T10:00:00Z",
"updated_at": "2026-09-14T10:12:30Z"
}
],
"next_cursor": null,
"has_more": false
}
Phone
List Phone Numbers
List the phone numbers in your organization.
GET
/
api
/
v1
/
phone
/
numbers
curl -X GET "https://api.wirebox.sh/api/v1/phone/numbers?limit=50" \
-H "Authorization: Bearer $WIREBOX_API_KEY"
{
"numbers": [
{
"id": "pn_01J8ABC123DEF456",
"phone_number": "+14155550123",
"country_code": "US",
"type": "local",
"region": "CA",
"agent_handle": "eva",
"agent_identity_id": "agt_01J8ABC123DEF456",
"status": "active",
"sms_status": "ready",
"sms_error_code": null,
"sms_error_detail": null,
"sms_ready_at": "2026-09-14T10:12:30Z",
"capabilities": { "sms": true, "mms": true, "voice": false },
"created_at": "2026-09-14T10:00:00Z",
"updated_at": "2026-09-14T10:12:30Z"
}
],
"next_cursor": null,
"has_more": false
}
Query parameters
integer
default:"50"
Number of results to return (1–100).
string
Cursor from a previous response’s
next_cursor.string
Filter by lifecycle status. Omit to exclude released numbers.
string
Filter by SMS readiness:
pending, ready, or assignment_failed.curl -X GET "https://api.wirebox.sh/api/v1/phone/numbers?limit=50" \
-H "Authorization: Bearer $WIREBOX_API_KEY"
{
"numbers": [
{
"id": "pn_01J8ABC123DEF456",
"phone_number": "+14155550123",
"country_code": "US",
"type": "local",
"region": "CA",
"agent_handle": "eva",
"agent_identity_id": "agt_01J8ABC123DEF456",
"status": "active",
"sms_status": "ready",
"sms_error_code": null,
"sms_error_detail": null,
"sms_ready_at": "2026-09-14T10:12:30Z",
"capabilities": { "sms": true, "mms": true, "voice": false },
"created_at": "2026-09-14T10:00:00Z",
"updated_at": "2026-09-14T10:12:30Z"
}
],
"next_cursor": null,
"has_more": false
}