Skip to main content
GET
List phone numbers

Authorizations

Authorization
string
header
required

Headers

Quo-Api-Version
enum<string>
required

API version header. Supported values: 2026-03-30

Available options:
2026-03-30

Query Parameters

limit
integer
default:10

Max number of items to return per page.

Required range: 1 <= x <= 50
after
string
Example:

"eyJsYXN0SWQiOiJVU211a09NaXBhIn0"

phoneNumber
string

Filter results to the phone number matching this E.164 value.

Pattern: ^\+[1-9]\d{1,14}$
Example:

"+15555555555"

include
enum<string>[]

Comma-separated list of optional payload sections to include. restrictions adds the number’s calling and messaging restrictions. Omitted sections are left out of the response entirely. The members assigned to a number are their own endpoint, GET /phone-numbers/{phoneNumberId}/users.

Maximum array length: 1
Available options:
restrictions
Example:

"restrictions"

Response

OK

data
object[]
required
nextCursor
string | null
required

Cursor for the next page, or null when there are no more pages.

Example:

"eyJsYXN0SWQiOiJVU211a09NaXBhIn0"