List Webhook Deliveries

Delivery attempts for one webhook, newest first.

GEThttps://api.foxreach.io/api/v1/webhooks/{webhook_id}/deliveries

Requires an API key with the read scope.

Each delivery carries the event it sent. failureReason is a short code (http_500, timeout, connection_error, or skipped:target_not_public when the URL no longer resolves to a public address); FoxReach does not keep what your endpoint replied with.

Path Parameters#

webhook_idstringpathrequired

The unique identifier of the webhook.

Query Parameters#

statusstringquery

Only deliveries with this status: pending, success or failed.

pageintegerquery

Page number, starting at 1.

pageSizeintegerquery

Results per page, 1 to 100. Default 50.

Response#

Returns a paginated list in data with meta.page, meta.pageSize, meta.total and meta.totalPages.

Errors#

Status	Description
`401`	Missing, invalid, revoked or expired API key
`403`	API key does not have the required scope: `read`
`404`	Webhook not found in this workspace
`422`	`pageSize` is above 100

Rate Limit#

300 requests per minute, shared by every read call in your workspace. Fixed 60-second window.
Every response includes X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset (unix epoch seconds) and X-RateLimit-Bucket (read).
A 429 response includes a Retry-After header (seconds until the bucket resets).

For client-side patterns, see Rate Limiting.

Request

cURL

curl -X GET "https://api.foxreach.io/api/v1/webhooks/cwh_abc123/deliveries?status=failed" \
  -H "X-API-Key: otr_your_key"

Python SDK

from foxreach import FoxReach

client = FoxReach(api_key="otr_your_key")
page = client.webhooks.deliveries("cwh_abc123", status="failed")

TypeScript SDK

import { FoxReach } from "foxreach";

const client = new FoxReach({ apiKey: "otr_your_key" });
const page = await client.webhooks.deliveries("cwh_abc123", { status: "failed" });

Response

JSON

{
  "data": [
    {
      "id": "cwd_abc123",
      "webhookId": "cwh_abc123",
      "eventId": "cev_xyz789",
      "status": "failed",
      "statusCode": 500,
      "failureReason": "http_500",
      "attempts": 3,
      "lastAttemptAt": "2026-11-04T09:30:00+00:00",
      "createdAt": "2026-11-04T09:28:00+00:00",
      "event": {
        "id": "cev_xyz789",
        "type": "reply.received",
        "payload": { "replyId": "rpl_abc123" },
        "createdAt": "2026-11-04T09:28:00+00:00"
      }
    }
  ],
  "meta": { "page": 1, "pageSize": 50, "total": 1, "totalPages": 1 }
}

Was this page helpful?

View as MarkdownLast updated November 4, 2026