List phone summaries

GET

/phones/list

Last modified:2026-10-03 07:48:01

OperationId:ListPhoneSummaries

Lists provisioned phones across every domain with a reduced set of fields: MAC address, model, domain, line 1's extension, and notes. A Super User reads every domain, or narrows the list with domain or reseller. Other scopes use GET /domains/{domain}/phones/list. Results are paged with start and limit.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Query Params

Responses

🟢200OK

application/json

One reduced row per phone. An empty array when none match.

Bodyapplication/json

🟠400Bad Request

🟠401Authentication Required

🟠403Forbidden

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://awqacore01.crexendocloud.com/ns-api/v2/phones/list?limit=100&start=0&domain=example.com&reseller=example-reseller&device-models-brand-and-model=Yealink%20T54W&model_LIKE=Yealink%&mac_LIKE=00005e%&notes=%Front%20Desk%&extension=1001' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Two phones

[
    {
        "device-provisioning-mac-address": "00005e005301",
        "device-models-brand-and-model": "Yealink T54W",
        "domain": "example.com",
        "device-provisioning-line-1-extensions": "1001a",
        "notes": "Front Desk"
    },
    {
        "device-provisioning-mac-address": "00005e005302",
        "device-models-brand-and-model": "Polycom VVX450",
        "domain": "example.com",
        "device-provisioning-line-1-extensions": "1002a",
        "notes": "Sales Queue"
    }
]

Modified at 2026-10-03 07:48:01

Count phones in domain

List phone summaries in domain