> ## Documentation Index > Fetch the complete documentation index at: https://docs.florists.digital/llms.txt > Use this file to discover all available pages before exploring further. # List webhook deliveries > Required scope: `partner.webhooks.manage`. ## OpenAPI ````yaml /api-reference/openapi.json get /webhooks/deliveries openapi: 3.1.0 info: title: Digital Florists Partner API version: v1 description: >- Orders, customers and products (reads plus customer creation) and outbound webhooks. Bearer authentication; per-shop base URL. servers: - url: https://{shop_domain}/api/partner/v1 description: Shop variables: shop_domain: default: your-shop.example security: - bearerAuth: [] paths: /webhooks/deliveries: get: tags: - Webhook deliveries summary: List webhook deliveries description: 'Required scope: `partner.webhooks.manage`.' operationId: partner.v1.webhooks.deliveries.index parameters: - name: per_page in: query schema: type: integer minimum: 1 maximum: 100 description: Page size. Values above the maximum are clamped. - name: cursor in: query schema: type: string responses: '200': description: A page of webhook deliveries. content: application/json: schema: $ref: '#/components/schemas/WebhookDeliveryList' examples: success: summary: Example response value: data: - id: 01J2EXAMPLEDELIVERY0000000 event: id: 01J2EXAMPLEEVENT0000000000 type: order.created occurred_at: '2026-06-27T10:15:20+01:00' status: delivered attempts: 1 response_status: 200 response_excerpt: ok next_attempt_at: null delivered_at: '2026-06-27T10:16:04+01:00' created_at: '2026-06-27T10:15:30+01:00' links: next: >- https://your-shop.example/api/partner/v1/webhooks/deliveries?cursor=eyJleGFtcGxlIjp0cnVlfQ prev: null meta: per_page: 25 has_more: true '401': $ref: '#/components/responses/AuthenticationException' description: >- Authentication failed, or the token is missing, invalid, expired, or revoked. '403': $ref: '#/components/responses/ForbiddenError' description: >- The token lacks the required scope, or API access is not enabled for this shop. '422': $ref: '#/components/responses/ValidationException' description: The request failed validation. '429': $ref: '#/components/responses/RateLimitError' description: >- Rate limit exceeded. Retry after the period given in the Retry-After header. '500': $ref: '#/components/responses/ServerError' description: An unexpected server error occurred. '503': $ref: '#/components/responses/ServiceUnavailableError' description: The partner API is temporarily disabled. Retry later. security: - bearerAuth: [] components: schemas: WebhookDeliveryList: type: object properties: data: type: array items: $ref: '#/components/schemas/WebhookDelivery' links: type: object properties: next: type: - string - 'null' prev: type: - string - 'null' required: - next - prev meta: type: object properties: per_page: type: integer minimum: 1 maximum: 100 has_more: type: boolean required: - per_page - has_more required: - data - links - meta title: WebhookDeliveryList example: data: - id: 01J2EXAMPLEDELIVERY0000000 event: id: 01J2EXAMPLEEVENT0000000000 type: order.created occurred_at: '2026-06-27T10:15:20+01:00' status: delivered attempts: 1 response_status: 200 response_excerpt: ok next_attempt_at: null delivered_at: '2026-06-27T10:16:04+01:00' created_at: '2026-06-27T10:15:30+01:00' links: next: >- https://your-shop.example/api/partner/v1/orders?cursor=eyJleGFtcGxlIjp0cnVlfQ prev: null meta: per_page: 25 has_more: true WebhookDelivery: type: object properties: id: type: string event: anyOf: - type: object properties: id: type: string example: 01J2EXAMPLEEVENT0000000000 type: type: string enum: - order.created - order.updated - order.assigned - order.status_changed - order.payment_status_changed example: order.created occurred_at: type: - string - 'null' format: date-time example: '2026-06-27T10:15:20+01:00' required: - id - type - occurred_at - type: 'null' status: type: string enum: - pending - delivered - failed - exhausted example: delivered attempts: type: integer response_status: type: - integer - 'null' example: 200 response_excerpt: type: - string - 'null' example: ok next_attempt_at: type: - string - 'null' format: date-time example: null delivered_at: type: - string - 'null' format: date-time example: '2026-06-27T10:16:04+01:00' created_at: type: - string - 'null' format: date-time example: '2026-06-27T10:15:30+01:00' required: - id - event - status - attempts - response_status - response_excerpt - next_attempt_at - delivered_at - created_at title: WebhookDelivery example: id: 01J2EXAMPLEDELIVERY0000000 event: id: 01J2EXAMPLEEVENT0000000000 type: order.created occurred_at: '2026-06-27T10:15:20+01:00' status: delivered attempts: 1 response_status: 200 response_excerpt: ok next_attempt_at: null delivered_at: '2026-06-27T10:16:04+01:00' created_at: '2026-06-27T10:15:30+01:00' responses: AuthenticationException: description: Unauthenticated content: application/json: schema: type: object properties: error: type: string description: Stable machine-readable error code. message: type: string description: Human-readable error overview. required: - error - message ForbiddenError: description: >- The token lacks the required scope, or API access is not enabled for this shop. content: application/json: schema: type: object properties: error: type: string description: Stable machine-readable error code. message: type: string description: Human-readable error overview. required: - error - message ValidationException: description: The request failed validation. content: application/json: schema: type: object properties: error: type: string description: Stable machine-readable error code. message: type: string description: Human-readable validation overview. errors: type: object additionalProperties: type: array items: type: string description: Validation messages keyed by request field. required: - error - message - errors RateLimitError: description: >- Rate limit exceeded. Retry after the period given in the Retry-After header. content: application/json: schema: type: object properties: error: type: string description: Stable machine-readable error code. message: type: string description: Human-readable error overview. retry_after: type: - integer - 'null' description: Seconds to wait before retrying. required: - error - message - retry_after ServerError: description: An unexpected server error occurred. content: application/json: schema: type: object properties: error: type: string description: Stable machine-readable error code. message: type: string description: Human-readable error overview. required: - error - message ServiceUnavailableError: description: The partner API is temporarily disabled. Retry later. content: application/json: schema: type: object properties: error: type: string description: Stable machine-readable error code. message: type: string description: Human-readable error overview. required: - error - message securitySchemes: bearerAuth: type: http scheme: bearer ````