Path parameters

• id string Required

  System ID (database UUID)

Query parameters

• page integer

  1-based page number.

  Minimum value is 1. Default value is 1.

• page_size integer

  Page size. Default 50, max 100.

  Minimum value is 1, maximum value is 100. Default value is 50.

• sort_by string

  Sort column (allowlist matches /alerts).

  Values are starts_at, severity, alertname, or status. Default value is starts_at.

• sort_direction string

  Values are asc or desc. Default value is desc.

• status array[string]

  Filter by Alertmanager state. Supports multiple values.

  Values are active, suppressed, or unprocessed.

• severity array[string]

  Filter by severity. Supports multiple values.

  Values are critical, warning, or info.

• alertname array[string]

  Filter by alertname. Supports multiple values.

Responses

• 200 application/json

  Active alerts retrieved successfully

  Hide response attributes Show response attributes object

  • code integer
  • message string
  • data object
    Hide data attributes Show data attributes object

    • alerts array[object]
      Hide alerts attributes Show alerts attributes object

      Active alert returned by Mimir Alertmanager. The fan-out includes silenced and inhibited alerts (not just active ones), so callers can render the muted/suppressed state. System identity (id, key, name, type) is carried as labels (system_id, system_key, system_name, system_type), stamped server-side at ingest time.

      • fingerprint string

        Alertmanager fingerprint (hex hash of labels)

      • labels object

        Alert labels. Always includes server-stamped identity labels (system_id, system_key, system_name, system_type, system_fqdn, system_ipv4, organization_id, organization_name, organization_vat, organization_type) plus the alert's own labels (alertname, severity, ...). Use system_id to link to the system detail page (/systems/:id) and organization_id to link to the organization.

        Hide labels attribute Show labels attribute object

        • * string Additional properties
      • annotations object
        Hide annotations attribute Show annotations attribute object

        • * string Additional properties
      • status object
        Hide status attributes Show status attributes object

        • state string

          Values are active, suppressed, or unprocessed.

        • silencedBy array[string]

          Active silence IDs muting this alert (non-empty → state is "suppressed")

        • inhibitedBy array[string]
      • startsAt string(date-time)
      • endsAt string(date-time)
      • generatorURL string

        Source URL of the alert (set by the pushing agent), if any

    • pagination object
      Hide pagination attributes Show pagination attributes object

      • page integer

        Current page number

        Minimum value is 1.

      • page_size integer

        Number of items per page

        Minimum value is 1, maximum value is 200.

      • total_count integer

        Total number of items

        Minimum value is 0.

      • total_pages integer

        Total number of pages

        Minimum value is 0.

      • has_next boolean

        Whether there is a next page

      • has_prev boolean

        Whether there is a previous page

      • next_page integer | null

        Next page number if available

      • prev_page integer | null

        Previous page number if available

      • sort_by string | null

        Field used for sorting

      • sort_direction string | null

        Sort direction

        Values are asc or desc.

• 401 application/json

  Unauthorized - invalid or missing token

  Hide response attributes Show response attributes object

  • code integer
  • message string
  • data object | null
• 403 application/json

  Forbidden - insufficient permissions

  Hide response attributes Show response attributes object

  • code integer
  • message string
  • data object | null
• 404 application/json

  Resource not found

  Hide response attributes Show response attributes object

  • code integer

    HTTP error code

  • message string

    Error message

  • data object
    Hide data attributes Show data attributes object

    • type string

      Type of error

      Values are validation_error or external_api_error.

    • errors array[object]
      Hide errors attributes Show errors attributes object

      • key string

        Field name that failed validation

      • message string

        Error code or message

      • value string

        Value that failed validation

    • details

      Additional error details