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

🟢200OK

application/json

Successful operation

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

Request Example

Shell

JavaScript

Java

Swift

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

Response Example

200 - Example 1

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

Modified at 2026-10-20 18:32:30

Query all risk register catalog entries

Get an account by id