> ## Documentation Index > Fetch the complete documentation index at: https://docs.revcenter.ai/llms.txt > Use this file to discover all available pages before exploring further. # List an endpoint's deliveries > What was sent to an endpoint, newest first: each event, its status (pending, delivered, failed, abandoned), attempts, the status code your endpoint answered, and when the next retry is. Does not use credits. Needs scope `webhooks:read`. ## OpenAPI ````yaml /openapi.json get /webhooks/{webhookId}/deliveries openapi: 3.1.0 info: title: Revcenter API version: v1 description: >- Projects, searches, scored candidates and shortlists. Generated from the agent API's registry. servers: - url: https://api.revcenter.ai/v1 security: - bearer: [] tags: - name: Login - name: Account - name: Actions - name: Reference - name: Projects - name: Searches - name: Scoring - name: Shortlists - name: Candidates - name: Webhooks - name: Health paths: /webhooks/{webhookId}/deliveries: get: tags: - Webhooks summary: List an endpoint's deliveries description: >- What was sent to an endpoint, newest first: each event, its status (pending, delivered, failed, abandoned), attempts, the status code your endpoint answered, and when the next retry is. Does not use credits. Needs scope `webhooks:read`. operationId: list_webhook_deliveries parameters: - name: webhookId in: path required: true description: A webhook id schema: type: string - name: limit in: query required: false description: Up to 500 per page (default 100; 50 for projects). schema: type: integer - name: cursor in: query required: false description: The `cursor` from the previous page. Omit for the first page. schema: type: string responses: '200': description: OK headers: X-RateLimit-Limit: description: >- Requests allowed this minute (the tighter of the key's and the workspace's). schema: type: integer X-RateLimit-Remaining: description: Requests left this minute. schema: type: integer X-RateLimit-Reset: description: When the minute resets, in Unix seconds. schema: type: integer content: application/json: schema: type: object properties: data: type: array items: $ref: '#/components/schemas/WebhookDelivery' cursor: type: - string - 'null' description: Pass as ?cursor= for the next page; null on the last. meta: $ref: '#/components/schemas/Meta' example: data: - id: 2f1e0d9c-8b7a-4e6d-9c5b-4a3f2e1d0c9b webhook_id: 5e4d3c2b-1a09-4f8e-9d7c-6b5a4f3e2d1c event_id: evt_4b1d0c9e8f7a6b5c4d3e2f1a0b9c8d7e event_type: search.completed status: delivered attempt: 1 response_status: 200 response_ms: 184 error: null next_attempt_at: null created_at: '2026-10-17T14:19:41.000Z' delivered_at: '2026-10-17T14:19:41.000Z' redelivery_of: null payload: id: evt_4b1d0c9e8f7a6b5c4d3e2f1a0b9c8d7e type: search.completed created_at: '2026-10-17T14:19:41.000Z' workspace_id: org_2xAmpLe api_version: '2026-10-19' data: search_id: 0b9e7d6c-5a4f-4e3d-8c2b-1a0f9e8d7c61 project_id: 6f1c2a0e-3b7d-4c1e-9a52-0d4e8b7c1a11 status: complete outcome: Shortlist ready stop_reason: target_reached profiles_read: 212 delivered: 14 shortlisted: 14 closed_at: '2026-10-17T14:19:40.000Z' links: search: >- https://api.revcenter.ai/v1/searches/0b9e7d6c-5a4f-4e3d-8c2b-1a0f9e8d7c61 records: >- https://api.revcenter.ai/v1/searches/0b9e7d6c-5a4f-4e3d-8c2b-1a0f9e8d7c61/records records_csv: >- https://api.revcenter.ai/v1/searches/0b9e7d6c-5a4f-4e3d-8c2b-1a0f9e8d7c61/records.csv shortlist: >- https://api.revcenter.ai/v1/projects/6f1c2a0e-3b7d-4c1e-9a52-0d4e8b7c1a11/shortlist shortlist_csv: >- https://api.revcenter.ai/v1/projects/6f1c2a0e-3b7d-4c1e-9a52-0d4e8b7c1a11/shortlist.csv cursor: null meta: request_id: req_01JABCDEF '400': $ref: '#/components/responses/Error' '401': $ref: '#/components/responses/Error' '402': $ref: '#/components/responses/Error' '403': $ref: '#/components/responses/Error' '404': $ref: '#/components/responses/Error' '409': $ref: '#/components/responses/Error' '429': $ref: '#/components/responses/Error' '500': $ref: '#/components/responses/Error' '503': $ref: '#/components/responses/Error' components: schemas: WebhookDelivery: type: object properties: id: type: string webhook_id: type: string event_id: type: string description: 'The same on every retry and redelivery: deduplicate on it.' event_type: type: string status: type: string enum: - pending - delivered - failed - abandoned description: >- failed: the last attempt failed and another is scheduled (next_attempt_at). abandoned: no more attempts. attempt: type: integer description: Attempts made. response_status: type: - integer - 'null' description: >- The HTTP status your endpoint answered; null when it could not be reached. response_ms: type: - integer - 'null' error: type: - string - 'null' next_attempt_at: type: - string - 'null' created_at: type: string delivered_at: type: - string - 'null' redelivery_of: type: - string - 'null' description: The delivery this one repeats. payload: $ref: '#/components/schemas/WebhookEvent' Meta: type: object properties: request_id: type: string total: type: integer description: On lists that count everything that matched. WebhookEvent: type: object description: >- What each delivery POSTs. data carries ids, counts and links, never profiles or contact details; read those through the links. properties: id: type: string type: type: string created_at: type: string workspace_id: type: string api_version: type: string enum: - '2026-10-19' data: type: object Error: type: object required: - error properties: error: type: object required: - code - message - request_id properties: code: type: string description: 'Stable: every code is on the Errors page.' message: type: string details: type: - object - 'null' description: >- Structured specifics, when there are any (for example retry_after_seconds). request_id: type: string meta: $ref: '#/components/schemas/Meta' example: error: code: search_not_found message: No search with that id in this workspace. details: null request_id: req_01JABCDEF meta: request_id: req_01JABCDEF responses: Error: description: 'An error: one envelope everywhere. A 429 carries Retry-After.' headers: X-RateLimit-Limit: description: >- Requests allowed this minute (the tighter of the key's and the workspace's). schema: type: integer X-RateLimit-Remaining: description: Requests left this minute. schema: type: integer X-RateLimit-Reset: description: When the minute resets, in Unix seconds. schema: type: integer Retry-After: description: Seconds to wait (on 429 and 503). schema: type: integer content: application/json: schema: $ref: '#/components/schemas/Error' securitySchemes: bearer: type: http scheme: bearer description: An API key from Settings → Usage → API (rvc_live_…). ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.