# List endpoints

Returns paginated endpoints (infected machines / stealer logs). Scope by domain(s).

Endpoint: GET /endpoints
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).

  - `status` (string)
    Filter by status (repeatable)
    Enum: "new", "investigating", "resolved", "false_positive"

  - `risk_level` (string)
    Filter by risk level; comma-separated

  - `sort` (string)
    Sort: prefix - for desc. Allowed: risk_level, date
    Example: "-risk_level"

## Response 200 fields (application/json):

  - `data` (array)

  - `data.id` (string)
    Example: "d4e5f6a7-b8c9-0123-def0-456789012345"

  - `data.date` (string,null)
    Example: "2025-12-04T14:30:00.000Z"

  - `data.added_at` (string,null)
    Example: "2025-12-05T01:09:22.879Z"

  - `data.metadata` (object,null)
    May contain exfiltration_date (ISO 8601) and other fields
    Example: {"exfiltration_date":"2025-12-04T14:30:00.000Z"}

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

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

  - `data.status` (string)
    Enum: "new", "investigating", "resolved", "false_positive"

  - `data.filename` (string)
    Example: "[US]93.101.28.33.rar"

  - `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\"]."