Get a phone number by ID
curl --request GET \
--url https://api.quo.com/phone-numbers/{phoneNumberId} \
--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"
}
}
}
}{
"message": "The input was invalid",
"docs": "https://quo.com/docs",
"title": "Bad Request",
"errors": [
{
"path": "/include",
"message": "Value must be one of: users, restrictions",
"value": "settings",
"schema": {
"type": "array"
}
}
]
}{
"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": "Phone number with ID PNlja6rrtI not found",
"docs": "https://quo.com/docs",
"title": "Not Found",
"trace": "6897907457496870895"
}{
"message": "We have encountered an unknown error",
"docs": "https://quo.com/docs",
"title": "Unknown",
"trace": "6897907457496870895"
}Phone Numbers
Get a phone number by ID
Retrieve a single phone number in your Quo workspace by its unique identifier. Assigned users and usage restrictions are opt-in through the include parameter.
GET
/
phone-numbers
/
{phoneNumberId}
Get a phone number by ID
curl --request GET \
--url https://api.quo.com/phone-numbers/{phoneNumberId} \
--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"
}
}
}
}{
"message": "The input was invalid",
"docs": "https://quo.com/docs",
"title": "Bad Request",
"errors": [
{
"path": "/include",
"message": "Value must be one of: users, restrictions",
"value": "settings",
"schema": {
"type": "array"
}
}
]
}{
"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": "Phone number with ID PNlja6rrtI not found",
"docs": "https://quo.com/docs",
"title": "Not Found",
"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 phone number being referenced (used).
Pattern:
^PN(.*)$Example:
"PNlja6rrtI"
Query Parameters
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"
Response
OK
Show child attributes
Show child attributes
Was this page helpful?