> ## Documentation Index > Fetch the complete documentation index at: https://docs-api.kravata.co/llms.txt > Use this file to discover all available pages before exploring further. # Get Webhook Deliveries > Returns the delivery history of your webhooks: every attempt Kravata made to notify your endpoints, its status and the last error. Use it to audit notifications and to detect events your server did not receive. #### Request | Field | Type | Required | Description | | --- | --- | --- | --- | | Authorization | Header | Yes | `Bearer ` obtained from **POST /api/v1/client/token**. | | fromDate | Query | No | Start of the range (ISO 8601). Defaults to 7 days before `toDate`. | | toDate | Query | No | End of the range (ISO 8601). Defaults to now. The range can span at most 90 days. | | endpointId | Query | No | Only deliveries of this webhook endpoint (`id` from **GET /api/v1/integration-endpoints**). | | event | Query | No | Only deliveries of this event, e.g. `operation.status_updated`. | | status | Query | No | `PENDING`, `SUCCESS`, `FAILED` or `RETRYING`. | | correlationId | Query | No | Only deliveries of this correlation ID. | | page | Query | No | Page number, starting at 1. Send it together with `pageSize`. | | pageSize | Query | No | Records per page (1-1000). Without `page` and `pageSize`, the first 50 records are returned. | Results are ordered from newest to oldest. #### Response A paginated envelope (`items`, `total`, `page`, `pageSize`, `orderBy`, `orderDirection`). Each item contains: | Field | Description | | --- | --- | | id | Identifier of the delivery. | | endpointId | Webhook endpoint that was notified. | | event | Event that triggered the delivery. | | status | `PENDING` (queued), `SUCCESS` (your server answered 2xx), `RETRYING` (failed, a new attempt is scheduled) or `FAILED` (all attempts failed). | | attempts / maxAttempts | Attempts made and maximum allowed (`retryConfig.max_attempts` of the endpoint). | | nextRetryAt | When the next attempt will be made, for `RETRYING`. | | lastError | Error of the last failed attempt, e.g. a timeout or an HTTP status from your server. | | payload | Event data that was sent. | | correlationId | Identifier that groups the deliveries of the same event. | | registerDate | When the delivery was created. | #### Errors | Status | When | | --- | --- | | 400 | `fromDate` is after `toDate`, or the range is longer than 90 days. | | 401 | Missing, invalid or expired access token. | ## OpenAPI ````yaml /stack/openapi.json get /api/v1/webhooks/deliveries openapi: 3.1.0 info: title: Kravata Stack API version: '2.0' description: >- Kravata Stack API: users, accounts, custody wallets, liquidity ramps and fiat payments. servers: - url: https://test-api-kore.kravata.co description: Test - url: https://partners-api.kravata.co description: Production (mTLS + IP allowlist) security: - bearerAuth: [] tags: - name: Authentication - name: Users - name: Accounts - name: Earn - name: Custody - name: Liquidity Ramps - name: Payments - name: Webhooks paths: /api/v1/webhooks/deliveries: get: tags: - Webhooks summary: Get Webhook Deliveries description: >- Returns the delivery history of your webhooks: every attempt Kravata made to notify your endpoints, its status and the last error. Use it to audit notifications and to detect events your server did not receive. #### Request | Field | Type | Required | Description | | --- | --- | --- | --- | | Authorization | Header | Yes | `Bearer ` obtained from **POST /api/v1/client/token**. | | fromDate | Query | No | Start of the range (ISO 8601). Defaults to 7 days before `toDate`. | | toDate | Query | No | End of the range (ISO 8601). Defaults to now. The range can span at most 90 days. | | endpointId | Query | No | Only deliveries of this webhook endpoint (`id` from **GET /api/v1/integration-endpoints**). | | event | Query | No | Only deliveries of this event, e.g. `operation.status_updated`. | | status | Query | No | `PENDING`, `SUCCESS`, `FAILED` or `RETRYING`. | | correlationId | Query | No | Only deliveries of this correlation ID. | | page | Query | No | Page number, starting at 1. Send it together with `pageSize`. | | pageSize | Query | No | Records per page (1-1000). Without `page` and `pageSize`, the first 50 records are returned. | Results are ordered from newest to oldest. #### Response A paginated envelope (`items`, `total`, `page`, `pageSize`, `orderBy`, `orderDirection`). Each item contains: | Field | Description | | --- | --- | | id | Identifier of the delivery. | | endpointId | Webhook endpoint that was notified. | | event | Event that triggered the delivery. | | status | `PENDING` (queued), `SUCCESS` (your server answered 2xx), `RETRYING` (failed, a new attempt is scheduled) or `FAILED` (all attempts failed). | | attempts / maxAttempts | Attempts made and maximum allowed (`retryConfig.max_attempts` of the endpoint). | | nextRetryAt | When the next attempt will be made, for `RETRYING`. | | lastError | Error of the last failed attempt, e.g. a timeout or an HTTP status from your server. | | payload | Event data that was sent. | | correlationId | Identifier that groups the deliveries of the same event. | | registerDate | When the delivery was created. | #### Errors | Status | When | | --- | --- | | 400 | `fromDate` is after `toDate`, or the range is longer than 90 days. | | 401 | Missing, invalid or expired access token. | operationId: get-webhook-deliveries parameters: - name: fromDate in: query required: false description: Start of the range (ISO 8601). schema: type: string example: '2026-09-24T00:00:00Z' - name: toDate in: query required: false description: End of the range (ISO 8601). Max 90 days. schema: type: string example: '2026-10-01T23:59:59Z' - name: endpointId in: query required: false description: Webhook endpoint ID. schema: type: string - name: event in: query required: false description: Event name. schema: type: string example: operation.status_updated - name: status in: query required: false description: PENDING, SUCCESS, FAILED or RETRYING. schema: type: string example: FAILED - name: correlationId in: query required: false description: Correlation ID. schema: type: string - name: page in: query required: false description: Page number (send with pageSize). schema: type: string example: '1' - name: pageSize in: query required: false description: Records per page (send with page). schema: type: string example: '50' responses: '200': description: OK content: application/json: schema: type: object properties: items: type: array items: type: object properties: id: type: string endpointId: type: string event: type: string status: type: string attempts: type: integer maxAttempts: type: integer nextRetryAt: type: string lastError: type: string payload: type: object properties: id: type: string status: type: string direction: type: string correlationId: type: string registerDate: type: string total: type: integer page: type: integer pageSize: type: integer orderBy: {} orderDirection: {} examples: webhook-deliveries: summary: Webhook deliveries value: items: - id: 3f1c2a9e-7b4d-4e2a-9c1f-0a8b6d5e4c21 endpointId: a7e5d0b2-1c3f-4b8a-9e6d-2f4c8b1a0d93 event: operation.status_updated status: RETRYING attempts: 2 maxAttempts: 3 nextRetryAt: '2026-10-01T15:42:10' lastError: 'HTTP 503: Service Unavailable' payload: id: 9d0ba2b6-6b84-4474-a0fd-456e3967eb4d status: COMPLETED direction: WITHDRAWAL correlationId: c0e1f2a3-4b5c-6d7e-8f90-a1b2c3d4e5f6 registerDate: '2026-10-01T15:37:02' - id: 8b2d4e6f-1a3c-4d5e-9f70-b1c2d3e4f5a6 endpointId: a7e5d0b2-1c3f-4b8a-9e6d-2f4c8b1a0d93 event: operation.created status: SUCCESS attempts: 1 maxAttempts: 3 nextRetryAt: null lastError: null payload: id: 9d0ba2b6-6b84-4474-a0fd-456e3967eb4d status: PENDING direction: WITHDRAWAL correlationId: d1e2f3a4-5b6c-7d8e-9f01-b2c3d4e5f6a7 registerDate: '2026-10-01T15:36:58' total: 2 page: 1 pageSize: 50 orderBy: null orderDirection: null components: securitySchemes: bearerAuth: type: http scheme: bearer description: Access token from POST /api/v1/client/token. ````