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"
}
},
"businessHours": {
"enabled": true,
"timezone": "America/New_York",
"schedule": {
"monday": {
"start": "0900",
"end": "0900"
},
"tuesday": {
"start": "0900",
"end": "0900"
},
"wednesday": {
"start": "0900",
"end": "0900"
},
"thursday": {
"start": "0900",
"end": "0900"
},
"friday": {
"start": "0900",
"end": "0900"
},
"saturday": {
"start": "0900",
"end": "0900"
},
"sunday": {
"start": "0900",
"end": "0900"
}
}
}
}
}{
"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"
}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.
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"
}
},
"businessHours": {
"enabled": true,
"timezone": "America/New_York",
"schedule": {
"monday": {
"start": "0900",
"end": "0900"
},
"tuesday": {
"start": "0900",
"end": "0900"
},
"wednesday": {
"start": "0900",
"end": "0900"
},
"thursday": {
"start": "0900",
"end": "0900"
},
"friday": {
"start": "0900",
"end": "0900"
},
"saturday": {
"start": "0900",
"end": "0900"
},
"sunday": {
"start": "0900",
"end": "0900"
}
}
}
}
}{
"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
2026-03-30 Path Parameters
The unique identifier of the phone number being referenced (used).
^PN(.*)$"PNlja6rrtI"
Query Parameters
Comma-separated list of optional payload sections to include. restrictions adds the number’s calling and messaging restrictions. businessHours adds the number’s business hours: whether they are enforced, their timezone, and the window for each day; with nothing stored, enabled is false, timezone is America/Los_Angeles and the schedule is null. businessHours is only available on this endpoint, not on the list. Omitted sections are left out of the response entirely. The members assigned to a number are their own endpoint, GET /phone-numbers/{phoneNumberId}/users.
2restrictions, businessHours "restrictions"
"businessHours"
"restrictions,businessHours"
Response
OK
Show child attributes
Show child attributes
Was this page helpful?