> ## Documentation Index > Fetch the complete documentation index at: https://docs.useanima.sh/llms.txt > Use this file to discover all available pages before exploring further. # Get webhooks deliveries ## OpenAPI ````yaml /openapi.json get /webhooks/{webhookId}/deliveries openapi: 3.1.1 info: title: Anima API version: 0.1.0 description: >- The Anima API provides programmatic access to unified infrastructure for AI agents: create and manage agents; send and receive email; place phone calls and send/receive SMS and voice; store and retrieve vault credentials; manage agent identity; and configure webhooks for real-time events. Authenticate using a Bearer token or an API key passed via the X-API-Key header. contact: name: Anima Labs url: https://useanima.sh email: support@useanima.sh license: name: MIT url: https://opensource.org/licenses/MIT servers: - url: https://api.useanima.sh/v1 description: Production security: - BearerAuth: [] - ApiKeyAuth: [] tags: - name: Agents description: Create and manage AI agents with email and phone capabilities - name: Inboxes description: Manage email inboxes and their configurations - name: Messages description: Send, receive, and search email messages - name: Webhooks description: Register and manage webhook subscriptions for real-time events - name: Organizations description: Manage organizations and team settings - name: Domains description: Configure and verify custom email domains - name: Phone description: Manage phone numbers and SMS/voice capabilities - name: Invoices description: Track invoices, match receipts, and reconcile payments - name: Billing description: View usage, tiers, and billing information - name: Security description: Configure security policies and access controls - name: Vault description: Store and retrieve encrypted secrets - name: API Keys description: Create and manage API keys for programmatic access paths: /webhooks/{webhookId}/deliveries: get: operationId: webhook.listDeliveries parameters: - name: webhookId in: path required: true schema: type: string pattern: ^[0-9a-z]+$ description: Filter deliveries to this specific webhook - name: cursor in: query required: false schema: type: string pattern: ^[0-9A-HJKMNP-TV-Z]{26}$ description: Opaque cursor from a previous response to fetch the next page allowEmptyValue: true allowReserved: true - name: limit in: query required: false schema: default: 20 type: integer minimum: 1 maximum: 100 description: Maximum number of items to return per page (1–100, default 20) allowEmptyValue: true allowReserved: true responses: '200': description: OK content: application/json: schema: type: object properties: items: type: array items: type: object properties: id: type: string pattern: ^[0-9a-z]+$ description: Unique identifier for this delivery attempt record webhookId: type: string pattern: ^[0-9a-z]+$ description: Webhook subscription this delivery belongs to messageId: anyOf: - type: string pattern: ^[0-9a-z]+$ - type: 'null' description: >- Associated message ID if the event is message-related event: enum: - message.received - message.sent - message.failed - message.bounced - agent.created - agent.updated - agent.deleted - phone.provisioned - phone.released - call.summary.ready - call.score.ready - call.security.alert - call.security.scan.ready - call.started - call.ended type: string description: Event type that triggered this delivery payload: type: object additionalProperties: {} description: JSON payload that was sent to the webhook endpoint statusCode: anyOf: - type: integer - type: 'null' description: >- HTTP status code returned by the endpoint, null if delivery failed responseBody: anyOf: - type: string - type: 'null' description: >- Response body returned by the endpoint, null if delivery failed attempts: type: integer minimum: 0 description: Number of delivery attempts made so far maxAttempts: type: integer minimum: 0 description: Maximum number of delivery attempts before giving up nextAttemptAt: anyOf: - type: string format: date-time - type: 'null' description: >- ISO 8601 timestamp of the next scheduled retry, null if completed or exhausted completedAt: anyOf: - type: string format: date-time - type: 'null' description: >- ISO 8601 timestamp when delivery succeeded or was abandoned status: enum: - PENDING - IN_FLIGHT - SUCCEEDED - RETRYING - DEAD_LETTERED type: string description: Lifecycle status of this delivery attempt lastError: anyOf: - type: string - type: 'null' description: >- Last error message if the delivery is retrying or dead-lettered deadLetteredAt: anyOf: - type: string format: date-time - type: 'null' description: >- When the delivery moved to the DLQ (null if still in flight or succeeded) createdAt: type: string format: date-time description: >- ISO 8601 timestamp when the delivery was first attempted required: - id - webhookId - messageId - event - payload - statusCode - responseBody - attempts - maxAttempts - nextAttemptAt - completedAt - status - lastError - deadLetteredAt - createdAt description: >- Record of a single webhook delivery attempt including status and retry information description: Array of webhook delivery records in the current page pagination: type: object properties: nextCursor: anyOf: - type: string pattern: ^[0-9A-HJKMNP-TV-Z]{26}$ - type: 'null' description: >- Cursor to pass as the `cursor` parameter to retrieve the next page, or null if no more results hasMore: type: boolean description: Whether additional pages of results are available required: - nextCursor - hasMore description: Cursor-based pagination metadata required: - items - pagination description: Paginated list of webhook delivery records components: securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: JWT description: >- JWT Bearer token obtained from authentication. Pass as: Authorization: Bearer ApiKeyAuth: type: apiKey in: header name: X-API-Key description: 'API key for programmatic access. Pass as: X-API-Key: ' ````