---
title: "Log de eventos da conta, por cursor"
method: GET
path: "/v1/eventos"
tags: ["Eventos"]
---

# Log de eventos da conta, por cursor

`GET /v1/eventos`

## Request

- Base URL: `https://api.sudrel.com.br/api`
- URL: `https://api.sudrel.com.br/api/v1/eventos`
- Auth: HTTP bearer

Chave de sandbox lê só eventos de sandbox, a de produção só os de
produção; chave restrita a uma empresa, só os dessa empresa.

## Query parameters

- `apos` string
- `tipos` string
- `limite` integer

## Response `200`

OK

- object
  - `eventos` EventoConta[]
    - `id` string: O mesmo `X-Sudrel-Event-Id` das entregas.
    - `seq` string: Posição no log (o cursor).
    - `tipo` string
    - `ocorrido_em` string, date-time
    - `ambiente` 'producao' | 'sandbox'
    - `empresa_id` string, nullable
    - `recurso` object
      - `tipo` 'nfse' | 'lote' | 'empresa' | 'documento' | 'pendencia_ecac'
      - `id` string
      - `url` string, nullable
    - `dados` object, nullable: O corpo do webhook, quando foi guardado.
  - `proximo_cursor` string

## Other responses

- `401`: `nao_autenticado`: chave de API ausente, inválida ou revogada.
- `410`: `cursor_vencido`: mais velho que a retenção de 90 dias. `cursor_mais_antigo` diz de onde continuar.
- `429`: `limite_de_requisicoes` (`retentavel: true`): 120 requisições por minuto por chave, janela fixa de 60 s. Sem `Retry-After`: espere a virada do minuto e repita a MESMA requisição (com a mesma `Idempotency-Key`).

---

[API](https://skmtc.dev/sudrel/apis/api-publica-sudrel-nfs-e-nf-e-e-ct-e.md) · [All operations](https://skmtc.dev/sudrel/apis/api-publica-sudrel-nfs-e-nf-e-e-ct-e/llms.txt) · [OpenAPI document](https://skmtc.dev/sudrel/apis/api-publica-sudrel-nfs-e-nf-e-e-ct-e/revisions/efd7baba9e37?raw)