> ## Documentation Index
> Fetch the complete documentation index at: https://docs.routa.chat/llms.txt
> Use this file to discover all available pages before exploring further.

# Listar entregas

> Lista as entregas de um endpoint, da mais recente para a mais antiga. Filtre por `state=exhausted` para ver as entregas que esgotaram as tentativas. As entregas ficam consultáveis por 30 dias.



## OpenAPI

````yaml openapi.json GET /v1/webhook_endpoints/{id}/deliveries
openapi: 3.0.3
info:
  title: API da Routa
  description: >-
    API REST para enviar e receber mensagens de WhatsApp, acompanhar a entrega e
    receber eventos normalizados por webhook.
  version: '1'
servers:
  - url: https://api.routa.chat
    description: Produção
security:
  - bearerAuth: []
tags:
  - name: Mensagens
    description: Envie, consulte e liste mensagens.
  - name: Eventos
    description: Consulte o log de eventos normalizados.
  - name: Webhooks
    description: Gerencie endpoints de webhook, segredos e entregas.
  - name: Templates
    description: Submeta e consulte templates de WhatsApp.
  - name: Mídia
    description: Envie e obtenha arquivos de mídia.
  - name: Uso
    description: Consulte o uso medido do projeto.
  - name: Identidade
    description: Identifique a chave de API em uso.
paths:
  /v1/webhook_endpoints/{id}/deliveries:
    get:
      tags:
        - Webhooks
      summary: Listar entregas
      description: >-
        Lista as entregas de um endpoint, da mais recente para a mais antiga.
        Filtre por `state=exhausted` para ver as entregas que esgotaram as
        tentativas. As entregas ficam consultáveis por 30 dias.
      operationId: listWebhookDeliveries
      parameters:
        - schema:
            type: string
          in: path
          name: id
          required: true
          description: Identificador do endpoint (`whe_...`).
        - schema:
            type: string
            enum:
              - pending
              - in_flight
              - retrying
              - succeeded
              - exhausted
          in: query
          name: state
          required: false
          description: Filtra pelo estado da entrega.
        - schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 20
          in: query
          name: limit
          required: false
          description: Quantidade de itens por página, de 1 a 100. O padrão é 20.
        - schema:
            type: string
          in: query
          name: cursor
          required: false
          description: Valor de `next_cursor` da página anterior. Trate-o como opaco.
      responses:
        '200':
          description: Sucesso
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WebhookDeliveryList'
        '401':
          description: >-
            Chave de API ausente, inválida, revogada ou expirada
            (`api_key_invalid`)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: A chave não tem o escopo necessário (`insufficient_scope`)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: O recurso não existe ou pertence a outro projeto
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '422':
          description: Requisição inválida
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Limite de taxa excedido. Veja o header `Retry-After`
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
        - bearerAuth:
            - webhooks:write
components:
  schemas:
    WebhookDeliveryList:
      type: object
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/WebhookDelivery'
          description: Entregas da página.
        has_more:
          type: boolean
          description: Indica se existem mais páginas.
        next_cursor:
          type: string
          nullable: true
          description: Cursor da próxima página, ou `null` na última.
      required:
        - data
        - has_more
        - next_cursor
    Error:
      type: object
      properties:
        error:
          type: object
          required:
            - type
            - code
            - message
            - request_id
          properties:
            type:
              type: string
              description: >-
                Categoria do erro: `invalid_request_error`,
                `authentication_error`, `permission_error`, `not_found_error`,
                `conflict_error`, `rate_limit_error`, `billing_error` ou
                `api_error`.
              example: invalid_request_error
            code:
              type: string
              description: >-
                Código estável e legível por máquina. Veja [Códigos de
                erro](/errors/error-codes).
              example: channel_inactive
            message:
              type: string
              description: >-
                Texto para humanos, em inglês. Pode mudar, então não faça parse
                dele.
              example: Channel chan_01J8... is not active and cannot send messages.
            param:
              type: string
              description: O campo da requisição com problema, quando se aplica.
            doc_url:
              type: string
              description: Link para a documentação do código, quando disponível.
            details:
              type: object
              additionalProperties:
                oneOf:
                  - type: string
                  - type: number
              description: >-
                Valores acionáveis, como `limit`, `used` e `resets_at` em
                `message_quota_exceeded`.
            request_id:
              type: string
              description: Identificador da requisição. Informe-o ao falar com o suporte.
              example: req_01J8ZK9M3Q7XABCDEFGHJKMNPQ
          description: Detalhes do erro.
      required:
        - error
    WebhookDelivery:
      type: object
      required:
        - id
        - event_id
        - event_type
        - state
        - attempt_count
        - next_attempt_at
        - last_response_status
        - last_error_code
        - succeeded_at
        - exhausted_at
        - created_at
      properties:
        id:
          type: string
          description: Identificador da entrega.
          example: whd_01J8ZK9M3Q7XABCDEFGHJKMNPQ
        event_id:
          type: string
          description: Evento entregue.
          example: evt_01J8ZK9M3Q7XABCDEFGHJKMNPQ
        event_type:
          type: string
          description: Tipo do evento entregue.
          example: message.delivered
        state:
          type: string
          enum:
            - pending
            - in_flight
            - retrying
            - succeeded
            - exhausted
          description: >-
            Estado da entrega: `pending`, `in_flight`, `retrying`, `succeeded`
            ou `exhausted`.
        attempt_count:
          type: number
          description: Tentativas realizadas.
        next_attempt_at:
          format: date-time
          type: string
          description: Quando ocorre a próxima tentativa.
        last_response_status:
          type: number
          nullable: true
          description: Status HTTP da última resposta do seu servidor, ou `null`.
        last_error_code:
          type: string
          nullable: true
          description: Código do último erro, como timeout ou falha de conexão, ou `null`.
        succeeded_at:
          format: date-time
          type: string
          nullable: true
          description: Quando a entrega teve sucesso, ou `null`.
        exhausted_at:
          format: date-time
          type: string
          nullable: true
          description: Quando esgotou as tentativas, ou `null`.
        created_at:
          format: date-time
          type: string
          description: Quando a entrega foi criada.
          example: '2026-09-04T13:22:41.031Z'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Chave de API do projeto, no formato `rt_live_...` ou `rt_test_...`,
        enviada como `Authorization: Bearer <chave>`.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.