List phone numbers
List the organization’s owned phone numbers (DIDs), newest first, with keyset pagination. Filter by lifecycle status, a free-text search over the E.164 number and label, or one or more tags; each row is enriched with a passively-derived liveness state so the inventory table can flag numbers that have stopped receiving inbound traffic. Pass ?fields=id,phone_number,status for a slim projection suited to lightweight sender-id pickers. Org-scoped and read-only.
Authorizations
Dashboard JWT token from Clerk
Query Parameters
Filter by lifecycle status (e.g. active, pending_compliance, released, suspended).
Free-text match against the E.164 number and label.
Comma-separated tag slugs; a row matching any supplied tag is returned.
Page size, most-recent first. Clamped server-side to the max page size.
x >= 1Opaque keyset cursor from the previous page's meta.pagination.cursor.
Optional comma-separated slim projection (e.g. id,phone_number,status).