List a user's phone numbers
curl --request GET \
--url https://api.quo.com/users/{userId}/phone-numbers \
--header 'Authorization: <api-key>' \
--header 'Quo-Api-Version: <quo-api-version>'{
"data": [
{
"id": "PNlja6rrtI",
"groupId": "GRcei8k90o",
"name": "My phone number",
"phoneNumber": "+15555555555",
"formattedNumber": "(555) 555-5555",
"forward": "+15555555555",
"portRequestId": "123abc",
"portingStatus": "completed",
"symbol": "🏡",
"createdAt": "2022-01-01T00:00:00Z",
"updatedAt": "2022-01-01T00:00:00Z",
"restrictions": {
"calling": {
"CA": "unrestricted",
"Intl": "unrestricted",
"US": "unrestricted"
},
"messaging": {
"CA": "unrestricted",
"Intl": "unrestricted",
"US": "unrestricted"
}
}
}
],
"nextCursor": "eyJsYXN0SWQiOiJVU211a09NaXBhIn0"
}{
"message": "The input was invalid",
"docs": "https://quo.com/docs",
"title": "Bad Request",
"errors": [
{
"path": "/userId",
"message": "Expected string to match '^US(.*)$'",
"value": "abc123",
"schema": {
"type": "TemplateLiteral",
"pattern": "^US(.*)$"
}
}
]
}{
"message": "Unauthorized",
"docs": "https://quo.com/docs",
"title": "Unauthorized",
"trace": "6897907457496870895"
}{
"message": "User is forbidden to perform this action",
"docs": "https://quo.com/docs",
"title": "Forbidden",
"trace": "6897907457496870895"
}{
"message": "We have encountered an unknown error",
"docs": "https://quo.com/docs",
"title": "Unknown",
"trace": "6897907457496870895"
}User Phone Numbers
List a user's phone numbers
Retrieve a paginated list of the phone numbers assigned to a specific user in your Quo workspace.
GET
/
users
/
{userId}
/
phone-numbers
List a user's phone numbers
curl --request GET \
--url https://api.quo.com/users/{userId}/phone-numbers \
--header 'Authorization: <api-key>' \
--header 'Quo-Api-Version: <quo-api-version>'{
"data": [
{
"id": "PNlja6rrtI",
"groupId": "GRcei8k90o",
"name": "My phone number",
"phoneNumber": "+15555555555",
"formattedNumber": "(555) 555-5555",
"forward": "+15555555555",
"portRequestId": "123abc",
"portingStatus": "completed",
"symbol": "🏡",
"createdAt": "2022-01-01T00:00:00Z",
"updatedAt": "2022-01-01T00:00:00Z",
"restrictions": {
"calling": {
"CA": "unrestricted",
"Intl": "unrestricted",
"US": "unrestricted"
},
"messaging": {
"CA": "unrestricted",
"Intl": "unrestricted",
"US": "unrestricted"
}
}
}
],
"nextCursor": "eyJsYXN0SWQiOiJVU211a09NaXBhIn0"
}{
"message": "The input was invalid",
"docs": "https://quo.com/docs",
"title": "Bad Request",
"errors": [
{
"path": "/userId",
"message": "Expected string to match '^US(.*)$'",
"value": "abc123",
"schema": {
"type": "TemplateLiteral",
"pattern": "^US(.*)$"
}
}
]
}{
"message": "Unauthorized",
"docs": "https://quo.com/docs",
"title": "Unauthorized",
"trace": "6897907457496870895"
}{
"message": "User is forbidden to perform this action",
"docs": "https://quo.com/docs",
"title": "Forbidden",
"trace": "6897907457496870895"
}{
"message": "We have encountered an unknown error",
"docs": "https://quo.com/docs",
"title": "Unknown",
"trace": "6897907457496870895"
}Authorizations
Headers
API version header. Supported values: 2026-03-30
Available options:
2026-03-30 Path Parameters
The unique identifier of the user whose phone numbers are being listed.
Pattern:
^US(.*)$Example:
"US123abc"
Query Parameters
Max number of items to return per page.
Required range:
1 <= x <= 50Example:
"eyJsYXN0SWQiOiJVU211a09NaXBhIn0"
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:
1Available options:
restrictions Example:
"restrictions"
Was this page helpful?