> ## Documentation Index > Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt > Use this file to discover all available pages before exploring further. # Listar entregas de eventos > Retorna uma página de registros de entrega de eventos com histórico de tentativas. Filtra por status, tipo de evento, id de webhook, id de operação e intervalo de datas. Paginação baseada em cursor: passe o nextCursor de uma resposta anterior para continuar. ## OpenAPI ````yaml pt/openapi/v3-current/spb.yaml get /v1/str/event-deliveries openapi: 3.1.0 info: contact: email: contact@lerian.studio name: Lerian Studio url: https://lerian.studio description: >- Interface OpenAPI 3.1 do Lerian SPB, a integração direta entre a instituição e o Sistema de Pagamentos Brasileiro (SPB) sobre a Rede do Sistema Financeiro Nacional (RSFN). Abrange o Sistema de Transferência de Reservas (STR): registro de mensagens e catálogo de capacidades, ciclo de vida das operações (transferências bancárias, repasses IBS, transferências de liquidez, devoluções e cancelamentos), consultas de conta de reservas e de horários, governança de alçada, conciliação e entrega de eventos. license: name: Lerian Studio General License title: Lerian SPB API version: 1.0.0 servers: - url: https://spb.sandbox.lerian.net security: [] tags: - description: >- Trilhas imutáveis de registros de auditoria para operações STR e eventos de ciclo de vida. name: Audit - description: >- Catálogo de capacidades STR que descreve os tipos de mensagem suportados e suas restrições. name: Capabilities - description: >- Inventário de certificados ICP-Brasil com rotação e ativação recarregáveis a quente. name: Certificates - description: >- Fila de aprovação maker-checker para emissões retidas acima de sua banda de alçada: listar pendentes, assinar (aprovar) e negar. name: EmissionApprovals - description: >- Registros de entrega de eventos por webhook com controle de retentativas para despachos falhos. name: EventDeliveries - description: >- Catálogo de eventos de operação que enumera os tipos de evento de domínio emitidos. name: Events - description: >- Registro de avisos recebidos da família GEN (GEN0001 eco de conectividade, GEN0004 erro de transmissão, GEN0005 aviso administrativo). name: GenNotices - description: >- Governança de alçada do SPB: a tabela de bandas de valor e os requisitos de assinatura por tipo de mensagem, recarregados a quente em tempo de execução. name: Governance - description: >- Estado bruto das mensagens STR: listar as mensagens e ler uma mensagem individual por NUOp. name: Messages - description: Resumos e métricas operacionais agregados das operações STR. name: OperationalIntelligence - description: >- Ciclo de vida das operações STR para transferências bancárias e repasses IBS, incluindo devoluções e cancelamentos. name: Operations - description: >- Estado de prontidão do serviço que abrange as autoverificações de inicialização e a saúde das dependências. name: Readiness - description: Casos de conciliação e as ações que resolvem as divergências de operação. name: Reconciliation - description: >- Suíte de relatórios STR: relatórios agregados síncronos por intervalo de datas (movimento financeiro, transações rejeitadas, volumetria) sobre o próprio registro de transmissão do Lerian SPB. name: Reports - description: >- Consultas de saldo de conta de reservas STR0013 e de extrato STR0014 (modo mensagem) e seus resultados assíncronos. name: ReserveQueries - description: >- Lista de responsáveis do participante GEN0019: atualizações de substituição total anunciadas ao BACEN. name: Responsibles - description: >- Programação de janelas de operação do STR que rege quando as operações podem ser enviadas. name: Schedule - description: >- Consultas de horários STR0001 de parte única (consulta de horários do STR) e seus resultados de grade STR0001R1 assíncronos. name: ScheduleQueries - description: Configurações de tempo de execução do SPB para a integração STR. name: Settings - description: >- Registro e gerenciamento de endpoints de webhook para a entrega de eventos. name: Webhooks - description: >- Fluxo (ordem obrigatória): certificado → prontidão → teste-de-conectividade → envio. Ative um certificado, confirme que o rail reporta prontidão, passe em um teste de conectividade e então envie uma operação. Cada etapa é seu próprio recurso; um envio não deve ser tentado antes de a prontidão passar. name: onboarding - description: >- Fluxo (ordem obrigatória): operação pai SETTLED → devolução/cancelamento. Uma devolução ou cancelamento é um sub-recurso de uma operação pai liquidada; o segmento de rota {operationId}/{endToEndID} impõe o pai estruturalmente. name: lifecycle paths: /v1/str/event-deliveries: get: tags: - EventDeliveries summary: Listar entregas de eventos description: >- Retorna uma página de registros de entrega de eventos com histórico de tentativas. Filtra por status, tipo de evento, id de webhook, id de operação e intervalo de datas. Paginação baseada em cursor: passe o nextCursor de uma resposta anterior para continuar. operationId: listEventDeliveries parameters: - description: >- Delivery status filter (PENDING, DELIVERED, FAILED, RETRYING, EXHAUSTED). explode: false in: query name: status schema: description: >- Delivery status filter (PENDING, DELIVERED, FAILED, RETRYING, EXHAUSTED). examples: - DELIVERED type: string - description: Canonical event type filter. explode: false in: query name: eventType schema: description: Canonical event type filter. examples: - str.operation.accepted type: string - description: Webhook endpoint UUID filter. explode: false in: query name: webhookId schema: description: Webhook endpoint UUID filter. examples: - 550e8400-e29b-41d4-a716-446655440012 type: string - description: Operation aggregate UUID filter. explode: false in: query name: operationId schema: description: Operation aggregate UUID filter. examples: - 550e8400-e29b-41d4-a716-446655440013 type: string - description: Inclusive start date (RFC3339 timestamp or YYYY-MM-DD). explode: false in: query name: startDate schema: description: Inclusive start date (RFC3339 timestamp or YYYY-MM-DD). examples: - '2026-06-14' type: string - description: Inclusive end date (RFC3339 timestamp or YYYY-MM-DD). explode: false in: query name: endDate schema: description: Inclusive end date (RFC3339 timestamp or YYYY-MM-DD). examples: - '2026-06-14' type: string - description: Opaque pagination cursor from a previous response. explode: false in: query name: cursor schema: description: Opaque pagination cursor from a previous response. type: string - description: Page size (1-100, default 50). explode: false in: query name: limit schema: default: 50 description: Page size (1-100, default 50). examples: - 24 format: int64 maximum: 100 minimum: 1 type: integer responses: '200': content: application/json: schema: $ref: '#/components/schemas/EventDeliveryListResponse' description: OK default: content: application/problem+json: schema: $ref: '#/components/schemas/Detail' description: Error security: - BearerAuth: [] components: schemas: EventDeliveryListResponse: additionalProperties: false properties: correlationId: description: >- Request-scoped correlation identifier echoing X-Request-ID, for pivoting from response to trace. examples: - 550e8400-e29b-41d4-a716-446655440005 type: string items: description: Event delivery records for the current page. items: $ref: '#/components/schemas/EventDeliveryResponse' type: - array - 'null' limit: description: Effective page size applied to this response. examples: - 24 format: int64 type: integer nextCursor: description: >- Opaque cursor for the next page; absent when this is the last page. Do not parse. type: string prevCursor: description: >- Opaque cursor for the previous page; reserved for future bidirectional cursoring. Do not parse. type: string required: - items - limit - correlationId type: object Detail: additionalProperties: false properties: code: description: >- Stable, machine-readable domain error code scoped to the emitting service (format: -NNNN). examples: - ERR-0001 type: string detail: description: >- A human-readable explanation specific to this occurrence of the problem. examples: - Property foo is required but is missing. type: string errors: description: Optional list of individual error details items: $ref: '#/components/schemas/ErrorDetail' type: - array - 'null' instance: description: >- A URI reference that identifies the specific occurrence of the problem. examples: - https://example.com/error-log/abc123 format: uri type: string status: description: HTTP status code examples: - 400 format: int64 type: integer title: description: >- A short, human-readable summary of the problem type. This value should not change between occurrences of the error. examples: - Bad Request type: string type: default: about:blank description: A URI reference to human-readable documentation for the error. examples: - https://example.com/errors/example format: uri type: string type: object EventDeliveryResponse: additionalProperties: false properties: attempts: description: Number of delivery attempts made so far. examples: - 1 format: int64 type: integer createdAt: description: RFC3339 UTC timestamp when the delivery record was created. examples: - '2026-06-14T12:00:00Z' type: string deliveryId: description: Event delivery UUID. examples: - 550e8400-e29b-41d4-a716-446655440010 type: string eventId: description: UUID of the control-plane event being delivered. examples: - 550e8400-e29b-41d4-a716-446655440011 type: string eventType: description: Canonical control-plane event type being delivered. examples: - str.operation.accepted type: string lastAttemptAt: description: >- RFC3339 UTC timestamp of the most recent attempt; omitted before the first attempt. examples: - '2026-06-14T12:00:00Z' type: string lastError: description: >- Summary of the most recent delivery error; omitted when the last attempt succeeded. type: string nextRetryAt: description: >- RFC3339 UTC timestamp when the next retry is scheduled; omitted when no retry is pending. examples: - '2026-06-14T12:00:00Z' type: string operationId: description: >- UUID of the related operation when the event is operation-scoped; omitted otherwise. examples: - 550e8400-e29b-41d4-a716-446655440013 type: string status: description: 'Delivery status: PENDING, DELIVERED, FAILED, RETRYING, or EXHAUSTED.' examples: - DELIVERED type: string updatedAt: description: RFC3339 UTC timestamp of the last delivery-record update. examples: - '2026-06-14T12:00:00Z' type: string webhookId: description: UUID of the destination webhook endpoint. examples: - 550e8400-e29b-41d4-a716-446655440012 type: string required: - deliveryId - eventId - webhookId - eventType - status - attempts - createdAt - updatedAt type: object ErrorDetail: additionalProperties: false properties: location: description: >- Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id' type: string message: description: Error message text type: string value: description: The value at the given location type: object securitySchemes: BearerAuth: bearerFormat: JWT description: JWT bearer token issued by the identity provider. scheme: bearer type: http ````