Skip to main content
GET
List a user's 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

Path Parameters

userId
string
required

The unique identifier of the user whose phone numbers are being listed.

Pattern: ^US(.*)$
Example:

"US123abc"

Query Parameters

limit
integer
default:10

Max number of items to return per page.

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

"eyJsYXN0SWQiOiJVU211a09NaXBhIn0"

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"