List user contacts (reduced)

GET

/domains/{domain}/users/{user}/contacts/list

Last modified:2026-10-09 00:38:10

OperationId:ListUserContacts

Lists the same rows as GET /domains/{domain}/users/{user}/contacts, reduced to what identifies a contact: unique-id, name, company, domain, and, on a directory row, user. Phone numbers, email, notes, and timestamps are on the full read.

Basic User, Advanced User, Simple User, Call Center Agent, and Call Center Supervisor can list their own contacts only. Site Manager can list its own contacts and those of users at its own site. Office Manager can list the contacts of any user in its domain, Reseller those of users in domains of its territory, and Super User any user's. Super User Read Only and Office Manager Read-Only can read too, platform-wide and in their own domain. A request for any other address book returns 403.

The query parameters of the full list apply here too. Append /list to a keyed path (.../contacts/{contact_id}/list) for one contact's reduced row.

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

🟢200Success

application/json

The reduced rows, sorted and paged like the full list.

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://awqacore01.crexendocloud.com/ns-api/v2/domains//users//contacts/list?name-first-name=Front&name-last-name=Desk&tags=cg-Vendors&includeDomain=yes&department=Sales&site=Main%20Office&sort=name-last-name%20asc&limit=100&start=undefined' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Reduced rows

includeDomain=yes.

[
    {
        "unique-id": "5f2b7c9e1a4d8e3b6c0f9a2d7e1b4c8a",
        "name-first-name": "Front",
        "name-last-name": "Desk",
        "company": "Example Supply Co",
        "domain": "example.com"
    },
    {
        "name-first-name": "Sales",
        "name-last-name": "Queue",
        "domain": "example.com",
        "user": "1002"
    },
    {
        "unique-id": "0c4e8a2f6b1d9e3a7c5f0b8d2e6a4c1f",
        "name-first-name": "Support",
        "name-last-name": "Line",
        "company": "Example Services",
        "domain": "example.com"
    }
]

Modified at 2026-10-09 00:38:10

Count user contacts

Read domain address