Webhook endpoints

List delivery failures

GET/v1/webhooks/{endpoint_id}/failures

The durable error journal (deliveries that exhausted their retries), most recent first, kept ~30 days. Successful deliveries are only counted in the stats: there is deliberately no per-delivery success log.

Required scoperead:webhooks

Rate limit60 requests per minute

curl 'https://api.fansquare.so/v1/webhooks/67a55c69-e54b-4b90-a9f9-e000f12eb3fd/failures' \
  -H "Authorization: Bearer $API_KEY" \
  -H "Fansquare-Version: Amethyste"

{
  "data": [
    {
      "id": "5bfc4962-082a-47f6-a4a8-309631c98ae6",
      "event_id": "4117a4c7-1ff6-4b33-a952-dd5ad1b2a4ad",
      "event_type": "order.created",
      "payload": {
        "id": "b387813a-7210-4db8-affc-a11197ea9002",
        "external_id": "45e1ccbf-f63f-4198-aa97-f1998abff33d",
        "order_date": "2026-10-12T21:14:00.000Z",
        "order_type": "tip",
        "gross_amount": 4900,
        "net_amount": 3920,
        "currency": "EUR",
        "creator_id": "m81IhLxdhzDGYs54rNp2",
        "fan_id": "a6df8022-e509-4575-ad28-e29c2d1d42dc",
        "fan_username": "alex_92",
        "attribution": {
          "user_id": "ki9DZXxpgGz7KiDqHj88eCxHg56W",
          "method": "message_link",
          "attributed_at": "2026-10-12T21:14:00.000Z"
        }
      },
      "occurred_at": "2026-10-12T21:14:00.000Z",
      "status_code": 500,
      "error": "HTTP 500: Internal Server Error",
      "attempts": 4,
      "failed_at": "2026-10-12T21:20:10.000Z",
      "replayed_at": null
    }
  ],
  "next_cursor": "KI7cfD0OLcWfeXZb1FTusJpz0nfKiYXPwHCZe-VXBaeQSX1w5BvO5UH-ua-dzNpXOTixzw"
}

Parameters

Headers

Fansquare-Versionstringrequired
API version to pin. Accepts the mineral name or the release date of a version.

Path

endpoint_idstringrequired
Webhook endpoint id (the id field of endpoint items).
format uuid

Query

cursorstring
Opaque cursor from the previous page (next_cursor).
limitinteger
Page size (1-100).
Default 50min 1max 100

Response

OK, application/json

dataarray of objectsrequired
idstringrequired
Failure id. Path parameter for the replay endpoint.
event_idstringrequired
The event this delivery carried (id of the webhook envelope).
event_typestringrequired
Type of the event (type of the webhook envelope).
Valuesorder.createdorder.refundedassignment.updatedconversation.ai_control_requestedping
payloadobjectrequired
The data object of the failed delivery, kept for replay.
occurred_atstringrequired
When the event happened (created_at of the webhook envelope).
format date-time
status_codeinteger | nullrequired
Last HTTP status returned by the endpoint, null on network errors.
errorstring | nullrequired
Response-body excerpt or transport error of the last attempt.
attemptsintegerrequired
Delivery attempts made before giving up (4 with the standard retry ladder).
failed_atstringrequired
When the last attempt failed (ISO 8601).
format date-time
replayed_atstring | nullrequired
When the failure was last replayed (POST …/replay), null if never.
format date-time
next_cursorstring | nullrequired

curl 'https://api.fansquare.so/v1/webhooks/67a55c69-e54b-4b90-a9f9-e000f12eb3fd/failures' \
  -H "Authorization: Bearer $API_KEY" \
  -H "Fansquare-Version: Amethyste"

{
  "data": [
    {
      "id": "5bfc4962-082a-47f6-a4a8-309631c98ae6",
      "event_id": "4117a4c7-1ff6-4b33-a952-dd5ad1b2a4ad",
      "event_type": "order.created",
      "payload": {
        "id": "b387813a-7210-4db8-affc-a11197ea9002",
        "external_id": "45e1ccbf-f63f-4198-aa97-f1998abff33d",
        "order_date": "2026-10-12T21:14:00.000Z",
        "order_type": "tip",
        "gross_amount": 4900,
        "net_amount": 3920,
        "currency": "EUR",
        "creator_id": "m81IhLxdhzDGYs54rNp2",
        "fan_id": "a6df8022-e509-4575-ad28-e29c2d1d42dc",
        "fan_username": "alex_92",
        "attribution": {
          "user_id": "ki9DZXxpgGz7KiDqHj88eCxHg56W",
          "method": "message_link",
          "attributed_at": "2026-10-12T21:14:00.000Z"
        }
      },
      "occurred_at": "2026-10-12T21:14:00.000Z",
      "status_code": 500,
      "error": "HTTP 500: Internal Server Error",
      "attempts": 4,
      "failed_at": "2026-10-12T21:20:10.000Z",
      "replayed_at": null
    }
  ],
  "next_cursor": "KI7cfD0OLcWfeXZb1FTusJpz0nfKiYXPwHCZe-VXBaeQSX1w5BvO5UH-ua-dzNpXOTixzw"
}