GET /alerts

Retorna alertas paginados por página (modelo offset), não por cursor. Ver Paginação.

Request

GET /api/v1/alerts?status=OPEN&page=1&limit=50
Authorization: Bearer $SENTINEX_JWT

Query params

Param	Tipo	Default	Notas
`status`	enum	n/a	Filtro de status do alerta
`client_id`	uuid	n/a	Filtra por cliente. O nome do parâmetro é `client_id`, e não `customer_id`
`page`	int	1	Base 1
`limit`	int	20	Máx 100, truncado sem erro
`format`	enum	n/a	Quando informado, a rota entrega exportação em vez de JSON paginado

Response 200

Os identificadores são UUID, e os campos opcionais são omitidos quando vazios.

{
  "success": true,
  "data": [
    {
      "id": "9c2a1b3e-1d0a-4b7f-8e2c-7a1b3c5d7e9f",
      "tenant_id": "a1b2c3d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
      "type": "SANCTIONS_HIT",
      "severity": "HIGH",
      "status": "OPEN",
      "title": "Counterparty exposure to known mixer",
      "rule_id": "R-CRYPTO-01",
      "rule_version": 1,
      "risk_score": 67,
      "sla_breached": false,
      "client_id": "c1b2c3d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
      "transaction_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
      "created_at": "2026-05-18T14:32:11Z"
    }
  ],
  "meta": {
    "page": 1,
    "limit": 50,
    "total": 137
  }
}

Não há next_cursor, has_more nem page_size. Você chegou ao fim quando page * limit >= meta.total.

Exemplos comuns

Alertas abertos, primeira página

GET /api/v1/alerts?status=OPEN&page=1&limit=50

Alertas de um cliente específico

GET /api/v1/alerts?client_id=c1b2c3d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d&status=OPEN

Superfície de API key

GET /api/v1/vasp/alerts usa limit (default 50, máximo 200) mais offset, e devolve o bloco pagination com total, limit e offset.