List accounts

POST

/accounts

Query and filter accounts known to Anzenna. This includes accounts
discovered via all data sources, even if that data source is not used as
Anzenna's identity source (controlled by the "Identity Source" setting in
the Anzenna dashboard).

Contrast this to "Query All People", which only returns the information that
is provided by the configured identity source and only exposes active users.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Successful operation

Body

🟠400

🟠401Unauthorized

🟠403Forbidden

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/accounts' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "query": "name='\''WINPC-4291'\'' AND status IN ('\''active'\'', '\''pending'\'')",
    "distinct_count": "string",
    "sort": "name desc, id",
    "limit": 10,
    "offset": 0,
    "include_total_count": true
}'

Response Example

200 - Example 1

{
    "pagination": {
        "count": 0,
        "total_count": 1000
    },
    "distinct_values": [
        {
            "value": null,
            "count": 0
        }
    ],
    "items": [
        {
            "id": "8CA67511-744C-4D74-B26E-7281CF88712F",
            "source": "unspecified",
            "external_id": "00u1e8VTUYyPDmZLkXXX",
            "email": "joe.smith@example.com",
            "name": "Joe Smith",
            "first_name": "John",
            "last_name": "Doe",
            "manager": "manager@example.com",
            "job_title": "Software Engineer",
            "department": "Engineering",
            "company": "Acme Inc",
            "division": "Product Division",
            "cost_center": "CC-001",
            "location": {
                "city": "San Francisco",
                "state": "CA",
                "country": "USA"
            },
            "level": 3,
            "state": "unspecified",
            "password_changed": "2021-01-15T00:00:00Z",
            "login": "john.doe",
            "phones": [
                "+1-555-123-4567"
            ],
            "aliases": [
                "john@example.com"
            ],
            "avatar": {
                "url": "https://example.com/avatars/user.jpg",
                "content_type": "image/jpeg"
            }
        }
    ]
}

Modified at 2026-02-10 23:10:01

Remove a category from multiple people

Get an account by id