> ## Documentation Index > Fetch the complete documentation index at: https://docs.usenexio.com/llms.txt > Use this file to discover all available pages before exploring further. # List Webhook Deliveries > List recent delivery attempts for a webhook endpoint, including HTTP status, latency, and retry state. ## OpenAPI ````yaml GET /api/v1/webhooks/{endpointID}/deliveries openapi: 3.1.0 info: title: Nexio API version: '1.0' description: | Nexio agentic infrastructure API. Configure engines for placement, entity analysis, and other patterns. Submit runs, poll for results, or subscribe to signed webhook callbacks. contact: email: support@usenexio.com url: https://docs.usenexio.com servers: - url: https://api.usenexio.com description: Production security: - BearerAuth: [] tags: - name: EngineManagement description: Create, configure, and manage inference engines. - name: Engines description: Engine-scoped endpoints for submitting runs and retrieving results. - name: Runs description: Retrieve and reconcile submitted runs. - name: Catalog description: >- Read current carriers and products extracted for the authenticated organization. - name: Environments description: Isolated tenancy scopes under your org (one live plus non-live sandboxes). - name: Webhooks description: Manage webhook endpoints for push-based delivery of terminal run events. paths: /api/v1/webhooks/{endpointID}/deliveries: get: tags: - Webhooks summary: List Webhook Deliveries description: | Returns delivery history for a webhook endpoint. Use query parameters to filter by status or event type. operationId: listWebhookDeliveries parameters: - $ref: '#/components/parameters/EndpointID' - name: status in: query description: Filter deliveries by status. schema: type: string enum: - pending - in_progress - success - dead_letter - cancelled - name: event_type in: query description: Filter deliveries by event type. schema: type: string enum: - run.completed - run.failed - run.superseded - name: cursor in: query description: Pagination cursor from a previous response. schema: type: string responses: '200': description: List of deliveries. content: application/json: schema: $ref: '#/components/schemas/ListDeliveriesResponse' example: deliveries: - id: d1234567-abcd-4000-8000-000000000001 event_id: evt_run123_completed endpoint_id: 550e8400-e29b-41d4-a716-446655440000 run_id: f912ee92-af38-4a4a-a49c-43ac089cc301 event_type: run.completed webhook_version: '2026-03-22' target_url: https://api.example.com/nexio/webhooks status: success attempt_count: 1 max_attempts: 6 next_attempt_at: '2026-03-22T12:00:01Z' next_attempt_trigger: automatic created_at: '2026-03-22T12:00:01Z' completed_at: '2026-03-22T12:00:02Z' last_status_code: 200 '401': $ref: '#/components/responses/Unauthorized' '404': $ref: '#/components/responses/WebhookNotFound' '429': $ref: '#/components/responses/RateLimited' components: parameters: EndpointID: name: endpointID in: path required: true description: Webhook endpoint UUID. schema: type: string format: uuid schemas: ListDeliveriesResponse: type: object additionalProperties: false required: - deliveries properties: deliveries: type: array items: $ref: '#/components/schemas/WebhookDelivery' next_cursor: type: string description: Pagination cursor. Omitted when there is no next page. WebhookDelivery: type: object additionalProperties: false required: - id - event_id - endpoint_id - run_id - event_type - webhook_version - target_url - status - attempt_count - max_attempts - next_attempt_at - next_attempt_trigger - created_at properties: id: type: string format: uuid description: Delivery identifier. event_id: type: string description: Deterministic event identifier. endpoint_id: type: string format: uuid description: Target endpoint identifier. run_id: type: string format: uuid description: Associated run identifier. event_type: type: string enum: - run.completed - run.failed - run.superseded description: Event type. webhook_version: type: string description: Payload version. target_url: type: string format: uri description: Snapshot of the endpoint URL at delivery creation time. status: type: string enum: - pending - in_progress - success - dead_letter - cancelled description: Current delivery status. attempt_count: type: integer description: Number of delivery attempts made. max_attempts: type: integer description: Maximum delivery attempts before dead-lettering. next_attempt_at: type: string format: date-time description: Scheduled time for the next retry. next_attempt_trigger: type: string enum: - automatic - manual description: >- Whether the next attempt belongs to automatic retry or manual resend. last_attempt_at: type: string format: date-time description: Timestamp of the most recent attempt. last_status_code: type: integer description: HTTP status code from the most recent attempt. last_error: type: string description: Error message from the most recent failed attempt. created_at: type: string format: date-time description: When the delivery was created. completed_at: type: string format: date-time description: When the delivery reached a terminal state. Error: type: object required: - code - message properties: code: type: string description: | Stable snake_case error identifier. Safe to match programmatically. Known codes: `invalid_request`, `invalid_input`, `unauthorized`, `auth_unavailable`, `rate_limited`, `missing_run_id`, `invalid_run_id`, `run_not_found`, `invalid_offerings`, `missing_input`, `queue_unreachable`, `engine_not_found`, `engine_slug_conflict`, `engine_archived`, `invalid_engine_type`, `validation_error`, `webhook_not_found`, `webhook_limit_exceeded`, `invalid_url`, `invalid_events`, `invalid_description`, `invalid_auth_token`, `missing_endpoint_id`, `invalid_endpoint_id`, `missing_delivery_id`, `invalid_delivery_id`, `delivery_not_found`, `delivery_not_resendable`, `insufficient_capability`, `engine_version_required`, `engine_version_exact_required`, `engine_version_not_found`, `engine_version_invalid_format`, `engine_version_draft_requires_sandbox_key`, `engine_version_none_released`, `test_scenario_sandbox_only`, `test_scenario_forbidden`, `test_scenario_exact_version_required`, `test_scenario_version_not_supported`, `invalid_test_scenario`, `request_bound_exceeded`, and `run_cap_exceeded`. message: type: string description: Human-readable error message. May change between versions. details: description: | Optional request-specific details. Request-bound failures use the `RequestBoundDetails` object. Validation failures may use an array of field issues or another documented object. responses: Unauthorized: description: Missing or invalid API key. content: application/json: schema: $ref: '#/components/schemas/Error' example: code: unauthorized message: Missing or invalid API key WebhookNotFound: description: Webhook endpoint not found. content: application/json: schema: $ref: '#/components/schemas/Error' example: code: webhook_not_found message: Webhook endpoint not found RateLimited: description: Rate limit exceeded. Retry after the window resets. headers: Retry-After: description: Seconds until the rate limit window resets. schema: type: integer content: application/json: schema: $ref: '#/components/schemas/Error' example: code: rate_limited message: Rate limit exceeded securitySchemes: BearerAuth: type: http scheme: bearer description: | Send the credential as `Authorization: Bearer `. Scoped partner credentials use the exclusive `nxsk_v1_...` namespace. Each scoped key is bound at issuance to one organization, one canonical named environment, an explicit engine set, and a least-privilege capability set. A malformed, unknown, rotated, or revoked `nxsk_` key fails closed and is never retried as a legacy key. Capabilities used by this API are `runs:write`, `runs:read`, `engines:read`, `catalog:read`, `webhooks:manage`, `runs:defensibility:read`, `runs:test`, and `converse:use`. Operation descriptions name the required capability. Grandfathered `nx_live_...` and `nx_test_...` keys retain their existing broad access during the compatibility window. ````