> ## Documentation Index > Fetch the complete documentation index at: https://docs.centaur.io/llms.txt > Use this file to discover all available pages before exploring further. # List webhook deliveries > Returns the deliveries of an endpoint, newest first, with their attempt state. Deliveries are kept for seven days. ## OpenAPI ````yaml /openapi-v2.json get /webhooks/{id}/deliveries openapi: 3.1.0 info: title: Centaur API version: 2.0.0 description: >- Public API for reading Centaur's data over REST, with a companion MCP surface, and for partners to manage the webhook endpoints that receive Centaur events. servers: - url: https://api.centaur.io/v2 description: Centaur API v2 security: [] tags: - name: System description: Health and service metadata endpoints. - name: Discovery description: Read-only trader and asset directory discovery endpoints. - name: Events description: >- Historical trade-event reads with source, trader, asset, and position context. - name: Messages description: >- Read-only access to source messages by message timestamp or Source Message ID. - name: Channel Summaries description: Generated channel narrative summaries selected by Source Window overlap. - name: Aggregate Summaries description: >- Generated aggregate narrative summaries selected by Aggregate Window overlap. - name: Positions description: Read-only position history and open-position live state reads. - name: Stats description: Read-only aggregate trader and asset stats. - name: Webhooks description: >- Register HTTPS endpoints that receive signed event deliveries, manage their state and secrets, replay past deliveries and inspect delivery history. Requires the `webhooks.manage` permission on a partner account. - name: Widgets description: >- Hosted widget reads restricted to enabled registrations and approved origins. externalDocs: description: Canonical Centaur API documentation url: https://docs.centaur.io paths: /webhooks/{id}/deliveries: get: tags: - Webhooks summary: List webhook deliveries description: >- Returns the deliveries of an endpoint, newest first, with their attempt state. Deliveries are kept for seven days. operationId: listWebhookDeliveries parameters: - schema: type: string format: uuid description: Endpoint ID. required: true description: Endpoint ID. name: id in: path - schema: type: string enum: - PENDING - HELD - IN_FLIGHT - SUCCEEDED - DEAD description: Only deliveries in this state. required: false description: Only deliveries in this state. name: status in: query - schema: type: integer minimum: 1 maximum: 200 description: Maximum number of deliveries to return. required: false description: Maximum number of deliveries to return. name: limit in: query - schema: type: string minLength: 1 description: Forward pagination cursor from `meta.nextCursor`. required: false description: Forward pagination cursor from `meta.nextCursor`. name: cursor in: query responses: '200': description: A page of deliveries content: application/json: schema: type: object properties: success: type: boolean enum: - true data: $ref: '#/components/schemas/WebhookDeliveriesResponseData' requestId: type: string example: c8e2c6e4-80dd-4ffc-9d66-4e31bf64c6b8 required: - success - data - requestId '400': description: Invalid cursor content: application/json: example: success: false error: code: INVALID_CURSOR message: Malformed cursor requestId: c8e2c6e4-80dd-4ffc-9d66-4e31bf64c6b8 schema: $ref: '#/components/schemas/ErrorEnvelope' '401': description: Missing or invalid API key content: application/json: example: success: false error: code: UNAUTHORIZED message: Unauthorized requestId: c8e2c6e4-80dd-4ffc-9d66-4e31bf64c6b8 schema: $ref: '#/components/schemas/ErrorEnvelope' '403': description: >- The API key lacks the `webhooks.manage` permission, or the account is not an active partner account (`PARTNER_REQUIRED`, `PARTNER_SUSPENDED`) content: application/json: example: success: false error: code: FORBIDDEN message: API key lacks webhooks.manage permission requestId: c8e2c6e4-80dd-4ffc-9d66-4e31bf64c6b8 schema: $ref: '#/components/schemas/ErrorEnvelope' '404': description: No such endpoint on this account content: application/json: example: success: false error: code: NOT_FOUND message: Webhook endpoint not found requestId: c8e2c6e4-80dd-4ffc-9d66-4e31bf64c6b8 schema: $ref: '#/components/schemas/ErrorEnvelope' '422': description: Request validation failed content: application/json: example: success: false error: code: VALIDATION_ERROR message: Request validation failed requestId: c8e2c6e4-80dd-4ffc-9d66-4e31bf64c6b8 schema: $ref: '#/components/schemas/ErrorEnvelope' '503': description: Authentication service temporarily unavailable headers: Retry-After: description: Seconds to wait before retrying authentication schema: type: integer minimum: 1 content: application/json: example: success: false error: code: AUTHENTICATION_UNAVAILABLE message: Authentication is temporarily unavailable requestId: c8e2c6e4-80dd-4ffc-9d66-4e31bf64c6b8 schema: $ref: '#/components/schemas/ErrorEnvelope' security: - ApiKeyAuth: [] components: schemas: WebhookDeliveriesResponseData: type: object properties: results: type: array items: $ref: '#/components/schemas/WebhookDelivery' description: Deliveries of the endpoint, newest first. meta: type: object properties: hasMore: type: boolean nextCursor: type: - string - 'null' serverTime: type: string format: date-time description: >- Server UTC time when this response was produced (ISO-8601). Anchor relative-time phrases such as "today" or "this week" on this value rather than on a cached one. required: - hasMore - nextCursor - serverTime required: - results - meta ErrorEnvelope: type: object properties: success: type: boolean enum: - false error: $ref: '#/components/schemas/Error' requestId: type: string example: c8e2c6e4-80dd-4ffc-9d66-4e31bf64c6b8 required: - success - error - requestId WebhookDelivery: type: object properties: id: type: integer description: Delivery ID. eventId: type: string format: uuid description: The event `id` this delivery carries. A replay carries the same one. eventType: $ref: '#/components/schemas/WebhookEventType' sequence: type: - integer - 'null' description: >- The `sequence` sent with this delivery, assigned at its first attempt. Null before then. status: $ref: '#/components/schemas/WebhookDeliveryStatus' attemptCount: type: integer description: POST attempts made so far. lastAttemptAt: type: - string - 'null' format: date-time description: When the latest attempt finished, or null. lastResponseStatus: type: - integer - 'null' description: >- HTTP status of the latest attempt, or null when there was no response (timeout, connection error). lastError: type: - string - 'null' description: Error of the latest failed attempt, or null. deliveredAt: type: - string - 'null' format: date-time description: When your endpoint acknowledged it with a 2xx, or null. replayOfDeliveryId: type: - integer - 'null' description: >- For a replayed delivery, the ID of the delivery it re-sends. Null otherwise. createdAt: type: string format: date-time description: When the delivery was queued. required: - id - eventId - eventType - sequence - status - attemptCount - lastAttemptAt - lastResponseStatus - lastError - deliveredAt - replayOfDeliveryId - createdAt Error: type: object properties: code: type: string description: Stable machine-readable error code. example: UNAUTHORIZED message: type: string description: Human-readable explanation for the failure. example: Unauthorized details: description: Optional structured details for validation or input failures. required: - code - message WebhookEventType: type: string enum: - trade_event.created - trade_event.deleted - feed_item.created - feed_item.updated - feed_item.deleted - positioning.trending.updated - positioning.specialist_ideas.updated - positioning.early_opportunities.updated - positioning.crowd_fade.updated - positioning.smart_money.updated - positioning.leaders_book.updated WebhookDeliveryStatus: type: string enum: - PENDING - HELD - IN_FLIGHT - SUCCEEDED - DEAD description: >- Delivery state. `PENDING` waits for its first or next attempt. `HELD` was created while the endpoint was paused or disabled and is not sent until you resume or replay. `IN_FLIGHT` is being sent. `SUCCEEDED` got a 2xx response. `DEAD` failed every retry; replay it to send it again. securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: API key issued by Centaur. x-default: ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.