> ## Documentation Index > Fetch the complete documentation index at: https://docs.vocobase.com/llms.txt > Use this file to discover all available pages before exploring further. # List recent deliveries for a webhook endpoint > Returns this endpoint's recent delivery attempts, newest first, cursor-paginated. Page by passing the previous response's `next_cursor`; a `null` cursor means there are no more pages. ## OpenAPI ````yaml /openapi.json get /config/webhooks/{id}/deliveries openapi: 3.1.0 info: title: Vocobase API version: '2.0' description: >- API for managing voice AI agents, documents, and calls on the Vocobase platform. servers: - url: https://api.vocobase.com/api/v2 description: Production security: - bearerAuth: [] tags: - name: Config description: >- Read and update account configuration, webhook settings, and telephony credentials. - name: Agents description: Create, read, update, and delete voice AI agents. - name: Voices description: >- List voice tiers, available voices, and stream preview audio for agent configuration. - name: Documents description: Upload, manage, and delete knowledge base documents. - name: Agent Documents description: Link and unlink documents to agents for knowledge base integration. - name: Calls description: Initiate outbound calls and view call history. - name: Phone Numbers description: >- Import DIDs, assign agents for inbound routing, and re-sync carrier Application bindings. - name: Inbound Routing Policies description: >- Define pre-answer routing decisions for inbound calls before AI sessions are created. - name: Telephony Connections description: Create, list, rename, and disconnect named V2 telephony connections. - name: VoiceLink Management description: Manage VoiceLink reseller clients, DID mapping, and readiness sync. - name: Projects description: Organize agents into projects. Every agent belongs to exactly one project. - name: Dictionaries description: Speech-recognition dictionary CRUD and agent attachment. - name: Sessions description: Browser-initiated WebRTC voice sessions for in-app voice agents. - name: Campaigns description: Batch outbound calling. - name: Billing description: Balance, transactions, and usage summaries. - name: Custom Functions description: HTTP endpoints the agent can call mid-conversation. - name: Extraction Sets description: Reusable sets of post-call extraction fields. - name: Lifecycle Hooks description: Automatic pre-call and post-call integration steps. - name: Messaging description: Bring-your-own WhatsApp sending. - name: Integration Logs description: Audit trail for integration calls. - name: Connectors description: Catalog of tools an agent can be connected to. - name: Customers description: B2B2B sub-tenants and their tool connections. - name: Agent Tools description: Binding connectors and connections to an agent. paths: /config/webhooks/{id}/deliveries: get: tags: - Config summary: List recent deliveries for a webhook endpoint description: >- Returns this endpoint's recent delivery attempts, newest first, cursor-paginated. Page by passing the previous response's `next_cursor`; a `null` cursor means there are no more pages. operationId: listWebhookEndpointDeliveries parameters: - name: id in: path required: true schema: type: string format: uuid description: Webhook endpoint ID. - name: limit in: query schema: type: integer minimum: 1 maximum: 100 default: 25 description: Number of deliveries to return. - name: cursor in: query schema: type: string format: uuid description: >- Delivery ID to page from. Pass the previous response's `next_cursor`. - name: status in: query schema: type: string enum: - PENDING - DELIVERING - DELIVERED - FAILED - EXHAUSTED description: Filter by delivery status (case-insensitive). responses: '200': description: Deliveries retrieved successfully. content: application/json: schema: type: object properties: success: type: boolean const: true data: type: object properties: deliveries: type: array items: $ref: '#/components/schemas/WebhookDelivery' next_cursor: type: - string - 'null' format: uuid description: >- Cursor for the next page, or `null` when there are no more pages. example: success: true data: deliveries: - id: d1e2f3a4-5678-90ab-cdef-1234567890ab event_type: session.completed status: DELIVERED attempts: 2 max_attempts: 5 session_id: 5f6e7d8c-1234-5678-9abc-def012345678 url: https://example.com/webhooks/vocobase last_response_status: 200 last_error: null next_attempt_at: null last_attempt_at: '2026-05-25T10:31:04.000Z' delivered_at: '2026-05-25T10:31:04.000Z' created_at: '2026-05-25T10:30:59.000Z' next_cursor: null '400': $ref: '#/components/responses/ValidationError' '401': $ref: '#/components/responses/Unauthorized' '404': $ref: '#/components/responses/NotFound' '500': $ref: '#/components/responses/InternalError' components: schemas: WebhookDelivery: type: object description: >- One attempt record for one (event, endpoint) pair. Every event fans out to a separate delivery row per matching endpoint, each with independent retry state. properties: id: type: string format: uuid description: Delivery ID. event_type: type: string description: >- The event that was delivered. One of `WebhookEventType`, or `webhook.test`. status: type: string enum: - PENDING - DELIVERING - DELIVERED - FAILED - EXHAUSTED description: '`EXHAUSTED` means every attempt was used without a 2xx response.' attempts: type: integer description: Attempts made so far. max_attempts: type: integer description: >- Total attempts before the delivery is exhausted. Currently 5 — the initial delivery plus four retries. session_id: type: - string - 'null' format: uuid description: Session the event belongs to, when the payload carried one. url: type: string format: uri description: >- URL snapshotted at enqueue time. In-flight retries keep using it even if the endpoint is later edited or deleted. last_response_status: type: - integer - 'null' description: HTTP status of the most recent attempt. last_error: type: - string - 'null' description: Error from the most recent failed attempt. next_attempt_at: type: - string - 'null' format: date-time last_attempt_at: type: - string - 'null' format: date-time delivered_at: type: - string - 'null' format: date-time created_at: type: string format: date-time ErrorResponse: type: object properties: success: type: boolean const: false error: type: object properties: code: type: string message: type: string required: - code - message required: - success - error responses: ValidationError: description: Validation error in request body or parameters. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: success: false error: code: VALIDATION_ERROR message: agent_name is required and must be max 50 characters Unauthorized: description: Missing or invalid API key. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: success: false error: code: UNAUTHORIZED message: Invalid or missing API key NotFound: description: Resource not found. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: success: false error: code: NOT_FOUND message: Resource not found InternalError: description: Unexpected server error. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: success: false error: code: INTERNAL_ERROR message: An unexpected error occurred securitySchemes: bearerAuth: type: http scheme: bearer description: >- API key in format: `rg_live_xxxx`. Pass as a Bearer token in the Authorization header. ````