Query all people

POST

/people

Query and filter people.

This endpoint only lists active users from the configured identity source.
To list all accounts known to Anzenna, including inactive users and users from
other data sources, use the "List Accounts" endpoint.

However, "Query All People" provides richer information about each user, such as
risk scores and other derived attributes.

Relations:

manager (Person): The person's manager

devices (Device): The person's devices. Warning - this is a one to many relation. This is not generally useful to find a user's devices because of the one to many joins resulting in duplicates, but it can be used to find a user without any devices (through devices.id IS NULL). It is not recommended to use it in any other fashion

Additional Filters:

category_label (string): Filter by custom category label text

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 '/people' \
--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": [
        {
            "categories": [
                "automation"
            ],
            "departed_time": "2021-01-01T00:00:00Z",
            "department": "EPD",
            "email": "joe.smith@example.com",
            "id": "8CA67511-744C-4D74-B26E-7281CF88712F",
            "job_category": "engineer",
            "job_title": "Engineer",
            "last_login": "2021-01-01T00:00:00Z",
            "location_city": "San Francisco",
            "location_country": "USA",
            "location_state": "CA",
            "manager_email": "john.lopez@example.com",
            "manager_name": "John Lopez",
            "name": "Joe Smith",
            "password_changed": "2021-01-01T00:00:00Z",
            "risk_factors": [
                {
                    "magnitude": 40,
                    "type": "sensitive_file"
                }
            ],
            "risk_score": 9.2,
            "state": "unspecified"
        }
    ]
}

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

List groups

Get departure analysis for a person