# List users

Returns paginated users — leaks grouped by login. Each user represents a unique identity (email or username) with an aggregated risk level across all associated leaks. Scope by domain(s).

Endpoint: GET /users
Version: 1.0.0
Security: ApiKeyAuth

## Query parameters:

  - `domain_id` (string)
    Domain UUID(s) to scope the request. Comma-separated for multiple. If omitted, all non-archived domains of the organization are used.
    Example: "a1b2c3d4-e5f6-7890-abcd-ef1234567890"

  - `page` (integer)
    Page number (1-based).

  - `per_page` (integer)
    Items per page (max 100).

  - `risk_level` (string)

  - `login` (string)
    Search by login (substring)

  - `sort` (string)
    Sort: prefix - for desc. Allowed: first_seen, login, risk_level

## Response 200 fields (application/json):

  - `data` (array)

  - `data.id` (string)
    Example: "c3d4e5f6-a7b8-9012-cdef-345678901234"

  - `data.login` (string)
    Example: "user@example.com"

  - `data.identity_type` (string)
    Enum: "email", "username"

  - `data.first_seen` (string,null)
    Example: "2025-12-01T08:00:00.000Z"

  - `data.risk_level` (integer)
    Example: 5

  - `data.risk_level_name` (string)
    Enum: "none", "low", "medium", "high"

  - `pagination` (object)

  - `pagination.page` (integer)
    Example: 1

  - `pagination.per_page` (integer)
    Example: 25

  - `pagination.total_pages` (integer)
    Example: 4

  - `pagination.total_results` (integer)
    Example: 92

## Response 400 fields (application/json):

  - `type` (string)
    Example: "validation_error"

  - `status` (integer)
    Example: 400

  - `detail` (string)
    Example: "Invalid sort field: \"foo\". Valid: [\"risk_level\", \"first_seen\", \"added_at\"]."

## Response 401 fields (application/json):

  - `type` (string)
    Example: "validation_error"

  - `status` (integer)
    Example: 400

  - `detail` (string)
    Example: "Invalid sort field: \"foo\". Valid: [\"risk_level\", \"first_seen\", \"added_at\"]."

## Response 403 fields (application/json):

  - `type` (string)
    Example: "validation_error"

  - `status` (integer)
    Example: 400

  - `detail` (string)
    Example: "Invalid sort field: \"foo\". Valid: [\"risk_level\", \"first_seen\", \"added_at\"]."