Skip to main content
GET
List phone numbers

Authorizations

Authorization
string
header
required

Dashboard JWT token from Clerk

Query Parameters

status
string

Filter by lifecycle status (e.g. active, pending_compliance, released, suspended).

Free-text match against the E.164 number and label.

tags
string

Comma-separated tag slugs; a row matching any supplied tag is returned.

limit
integer

Page size, most-recent first. Clamped server-side to the max page size.

Required range: x >= 1
cursor
string

Opaque keyset cursor from the previous page's meta.pagination.cursor.

fields
string

Optional comma-separated slim projection (e.g. id,phone_number,status).

Response

200 - application/json

A page of the organization's owned phone numbers.

data
object[]
required
meta
object
required