> ## Documentation Index > Fetch the complete documentation index at: https://formcarry.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # List deliveries > The delivery log of the webhook, sorted by newest first. One entry per submission with its latest outcome: the HTTP status your endpoint returned, plus the error text if it failed. Filter with `status`; page with `limit` and `before`. Deliveries are kept for 18 months. ## OpenAPI ````yaml https://api.formcarry.com/docs-json get /v1/forms/{form_id}/webhooks/{webhook_id}/deliveries openapi: 3.0.0 info: title: formcarry API description: >- Welcome to the formcarry API. Authenticate every request with an API key from your team's API page in the dashboard, sent as `Authorization: Bearer fc_live_...`. Requests and responses are JSON. Lists are paginated with a cursor: pass a response's `next_cursor` as `cursor` to get the next page, until `next_cursor` is null. Errors return a `code` you can act on and a `message` you can show. Every response includes an `X-Request-Id` header; quote it when you contact support. version: '1' contact: {} servers: - url: https://api.formcarry.com security: [] tags: - name: forms description: Your forms - name: submissions description: Submissions received by a form - name: me description: The key you are using - name: health description: Service status paths: /v1/forms/{form_id}/webhooks/{webhook_id}/deliveries: get: tags: - forms summary: List deliveries description: >- The delivery log of the webhook, sorted by newest first. One entry per submission with its latest outcome: the HTTP status your endpoint returned, plus the error text if it failed. Filter with `status`; page with `limit` and `before`. Deliveries are kept for 18 months. operationId: WebhooksController_deliveries parameters: - name: form_id required: true in: path description: >- The form's id, as shown in the dashboard and in the form's endpoint URL example: AbC123xyz schema: type: string - name: webhook_id required: true in: path description: The webhook's id, from the list or from the response that created it example: whk_3f9Kq2bLm8xZpQ1rT7vWc0 schema: type: string - name: status required: false in: query description: >- Only deliveries in this state. retrying means another attempt is scheduled. schema: enum: - succeeded - failed - retrying - pending - skipped type: string - name: limit required: false in: query description: Page size, 1 to 100. Defaults to 25. schema: minimum: 1 maximum: 100 default: 25 type: number - name: before required: false in: query example: '2026-09-13T12:00:00.000Z' description: >- Deliveries before this time: pass the previous page's last occurred_at to get the next page. schema: type: string responses: '200': description: '' content: application/json: schema: $ref: '#/components/schemas/WebhookDeliveryList' '400': description: A filter has the wrong value. content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' examples: invalid_parameter: summary: invalid_parameter value: error: type: invalid_request_error code: invalid_parameter message: >- status must be one of the following values: succeeded, failed, retrying, pending, skipped param: status request_id: 2f9c1a7e-5b31-4d2e-9c0a-8e7f6d5c4b3a '401': description: The request carried no usable key or token. content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' examples: missing_bearer: summary: missing_bearer value: error: type: authentication_error code: missing_bearer message: >- Send your key as "Authorization: Bearer fc_live_..." on every request. request_id: 2f9c1a7e-5b31-4d2e-9c0a-8e7f6d5c4b3a invalid_key: summary: invalid_key value: error: type: authentication_error code: invalid_key message: >- This API key or access token is unknown, revoked or expired. request_id: 2f9c1a7e-5b31-4d2e-9c0a-8e7f6d5c4b3a wrong_audience: summary: wrong_audience value: error: type: authentication_error code: wrong_audience message: >- This access token was issued for a different resource. Authorize again for this server. request_id: 2f9c1a7e-5b31-4d2e-9c0a-8e7f6d5c4b3a '403': description: The key is valid but may not do this. content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' examples: insufficient_scope: summary: insufficient_scope value: error: type: permission_error code: insufficient_scope message: This key is missing the submissions:write scope. required: - submissions:write request_id: 2f9c1a7e-5b31-4d2e-9c0a-8e7f6d5c4b3a form_access_restricted: summary: form_access_restricted value: error: type: permission_error code: form_access_restricted message: >- This key is restricted to specific forms and cannot create new ones. request_id: 2f9c1a7e-5b31-4d2e-9c0a-8e7f6d5c4b3a team_inactive: summary: team_inactive value: error: type: permission_error code: team_inactive message: The team that owns this key is not active. request_id: 2f9c1a7e-5b31-4d2e-9c0a-8e7f6d5c4b3a owner_unverified: summary: owner_unverified value: error: type: permission_error code: owner_unverified message: >- The team owner must verify their email address before the API can be used. request_id: 2f9c1a7e-5b31-4d2e-9c0a-8e7f6d5c4b3a '404': description: No such form for this key, or no such webhook on it. content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' examples: form_not_found: summary: form_not_found value: error: type: invalid_request_error code: form_not_found message: No form with that id is accessible with this key. request_id: 2f9c1a7e-5b31-4d2e-9c0a-8e7f6d5c4b3a webhook_not_found: summary: webhook_not_found value: error: type: invalid_request_error code: webhook_not_found message: No webhook with that id exists on this form. request_id: 2f9c1a7e-5b31-4d2e-9c0a-8e7f6d5c4b3a '429': description: Slow down and retry after the Retry-After header. content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' examples: rate_limited: summary: rate_limited value: error: type: rate_limit_error code: rate_limited message: Too many requests. request_id: 2f9c1a7e-5b31-4d2e-9c0a-8e7f6d5c4b3a scan_concurrency: summary: scan_concurrency value: error: type: rate_limit_error code: scan_concurrency message: >- At most 2 filtered submission requests may run at once per key. Wait for the running ones to finish. request_id: 2f9c1a7e-5b31-4d2e-9c0a-8e7f6d5c4b3a '503': description: The delivery log could not be read. Try again in a minute. content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' examples: delivery_log_unavailable: summary: delivery_log_unavailable value: error: type: api_error code: delivery_log_unavailable message: >- The delivery log could not be read just now. Try again in a minute. request_id: 2f9c1a7e-5b31-4d2e-9c0a-8e7f6d5c4b3a security: - api_key: [] components: schemas: WebhookDeliveryList: type: object properties: data: type: array items: $ref: '#/components/schemas/WebhookDeliveryResource' has_more: type: boolean description: >- More deliveries exist before the last one listed. Pass its occurred_at as before. required: - data - has_more ErrorEnvelope: type: object properties: error: $ref: '#/components/schemas/ErrorBody' required: - error WebhookDeliveryResource: type: object properties: submission_id: type: string example: 64c000000000000000000001 webhook_id: type: string example: whk_3f9Kq2bLm8xZpQ1rT7vWc0 description: Empty on deliveries from before webhooks had ids. status: type: string enum: - succeeded - failed - retrying - pending - skipped description: >- The latest outcome for this submission. Retries run for up to 3 days, then the state is failed. code: type: string example: ERROR_WEBHOOK_HTTP_5XX description: SUCCESS, or the error family of the last attempt. attempt: type: number nullable: true example: 3 description: Attempts so far. http_status: type: number nullable: true example: 502 description: The HTTP status your endpoint answered, when it answered. node_error_code: type: string nullable: true example: ECONNREFUSED description: The network error when the endpoint did not answer. message: type: string nullable: true description: The error text of the last attempt, up to 1024 characters. occurred_at: type: string example: '2026-09-13T12:00:00.000Z' description: When the last attempt ended. required: - submission_id - webhook_id - status - code - attempt - http_status - node_error_code - message - occurred_at ErrorBody: type: object properties: type: type: string enum: - authentication_error - permission_error - invalid_request_error - rate_limit_error - api_error example: invalid_request_error code: type: string example: invalid_parameter message: type: string example: limit must not be greater than 100 param: type: string description: The offending parameter, when there is one example: limit required: description: >- On insufficient_scope: the scopes the request needs. Reissue the key with them. example: - submissions:write type: array items: type: string retry_after: type: number description: 'On scan_concurrency: seconds to wait before trying again.' example: 2 request_id: type: string description: Echoes X-Request-Id. Quote it when contacting support. example: 2f9c1a7e-5b31-4d2e-9c0a-8e7f6d5c4b3a required: - type - code - message - request_id securitySchemes: api_key: scheme: bearer bearerFormat: fc_live_... type: http ```` ## Related topics - [List webhooks](/docs/api-reference/forms/list-webhooks.md) - [Retrieve a delivery](/docs/api-reference/forms/retrieve-a-delivery.md) - [List forms](/docs/api-reference/forms/list-forms.md) - [Use Your Own SMTP Server for Formcarry Email Delivery](/docs/email/custom-email-servers.md) - [Connect over MCP](/docs/connect.md)