Skip to main content
GET
List phone numbers

Authorizations

Authorization
string
header
required

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

Query Parameters

status
enum<string>

Filter by phone number status. Billing state of an owned number, separate from regulatoryStatus. pending is legacy and is not written to numbers today. The SDKs carry active, suspended and pending only; releasing and released are returned by the REST API until their next release.

Available options:
active,
suspended,
pending,
releasing,
released
limit
integer
default:50
Required range: x <= 100
cursor
string

Pagination cursor.

Response

List of phone numbers.

items
object[]
required
nextCursor
string | null