List phone templates

GET

/domains/{domain}/phonetemplates

Last modified:2026-10-09 00:48:26

OperationId:ReadPhoneTemplatesAvailableDomain

Returns the phone templates a domain can use in the phone template builder. A phone template is a reusable button layout for one phone brand and model. Each row is a summary: read one template for its buttons, directory, sidecars, and extra settings.

Results also include the platform-wide templates that every domain shares. Their phoneconfiguration-domain is *. You can read them but not change them.

Filter with phoneconfiguration-brand, phoneconfiguration-model, and phoneconfiguration-description. Each is an exact match. Page with start and limit: limit defaults to 100. GET /domains/{domain}/phonetemplates/count returns how many there are.

Requires Office Manager scope or above for your own domain, Reseller scope for the domains in your territory, or Super User scope. Office Manager Read-Only can read. Below Reseller scope, the domain of your token is read, whatever domain the path names.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Path Params

Query Params

Responses

🟢200OK

application/json

The templates. An empty array when there are none.

Bodyapplication/json

🟠401Unauthorized

🟠403Forbidden

🟠404Not Found

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://awqacore01.crexendocloud.com/ns-api/v2/domains//phonetemplates?phoneconfiguration-brand=Grandstream&phoneconfiguration-model=WP826&phoneconfiguration-description=Front%20desk%20layout%20with%20queue%20toggle&start=undefined&limit=undefined' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Domain and platform templates

[
    {
        "phoneconfiguration-name": "Front Desk WP826",
        "phoneconfiguration-description": "Front desk layout with queue toggle",
        "phoneconfiguration-brand": "Grandstream",
        "phoneconfiguration-model": "WP826",
        "phoneconfiguration-domain": "example.com",
        "last-modified-datetime": "2026-09-01T14:30:00+00:00"
    },
    {
        "phoneconfiguration-name": "Standard WP826",
        "phoneconfiguration-description": "Platform default layout",
        "phoneconfiguration-brand": "Grandstream",
        "phoneconfiguration-model": "WP826",
        "phoneconfiguration-domain": "*",
        "last-modified-datetime": "2026-08-14T09:00:00+00:00"
    }
]

Modified at 2026-10-09 00:48:26

List phone summaries in domain

Read phone template