List deliveries

GET/v1/webhooks/{id}/deliveriesKey scope read

Lists the deliveries made to one endpoint, newest first, with the response status, the error and the log of attempts. Deliveries are kept for 30 days.

Needs a key with the read scope. Authentication

curl "https://api.useinfrared.com/v1/webhooks/whe_2HLyVEWQelwo16welH16NM/deliveries?limit=2" \
  -H "Authorization: Bearer $INFRARED_KEY"

const response = await fetch("https://api.useinfrared.com/v1/webhooks/whe_2HLyVEWQelwo16welH16NM/deliveries?limit=2", {
  headers: { Authorization: `Bearer ${process.env.INFRARED_KEY}` },
});

const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.useinfrared.com/v1/webhooks/whe_2HLyVEWQelwo16welH16NM/deliveries",
    headers={"Authorization": f"Bearer {os.environ['INFRARED_KEY']}"},
    params={
        "limit": 2,
    },
)

data = response.json()

200 OKResponse

{
  "object": "list",
  "data": [
    {
      "object": "webhook_delivery",
      "id": "whd_4NNJEqwkLoeyB3ffT89sPT",
      "endpoint_id": "whe_2HLyVEWQelwo16welH16NM",
      "event_id": "evt_776dPiJmyI8U3ftKGhZdRG",
      "event_type": "moderation.completed",
      "status": "succeeded",
      "attempts": 1,
      "response_status": 200,
      "error": null,
      "duration_ms": 406,
      "next_attempt_at": null,
      "delivered_at": "2026-10-08T09:29:11.004Z",
      "replayed_from_id": null,
      "attempt_log": [
        {
          "at": "2026-10-08T09:29:11.004Z",
          "error": null,
          "status": 200,
          "duration_ms": 406
        }
      ],
      "created_at": "2026-10-08T09:29:10.252Z"
    },
    {
      "object": "webhook_delivery",
      "id": "whd_1E9GbP1DsPXVrvwq7ByOvl",
      "endpoint_id": "whe_2HLyVEWQelwo16welH16NM",
      "event_id": "evt_6EUOkCyLLkWpsD5xQvfi7v",
      "event_type": "queue_item.created",
      "status": "succeeded",
      "attempts": 1,
      "response_status": 200,
      "error": null,
      "duration_ms": 241,
      "next_attempt_at": null,
      "delivered_at": "2026-10-08T09:29:10.441Z",
      "replayed_from_id": null,
      "attempt_log": [
        {
          "at": "2026-10-08T09:29:10.441Z",
          "error": null,
          "status": 200,
          "duration_ms": 241
        }
      ],
      "created_at": "2026-10-08T09:29:09.844Z"
    }
  ],
  "has_more": true,
  "next_cursor": "WyIyMDI2LTEwLTA4VDA5OjI5OjA5Ljg0NFoiLCIyODVhZjkwZC1hYjI4LTRlNzMtYjBlMS1jNjMyMThiMmZmNGQiXQ"
}

Path parameters

idstringRequired: Id of the endpoint: whe_ plus 22 base62 characters.

Query parameters

limitintegerDefault 20

Number of items to return, 1 to 100. Default 20.

cursorstring

The next_cursor of the previous page. Omit it for the first page.

statusenum

Return only deliveries in this status: pending, succeeded, failed or exhausted.

One ofpendingsucceededfailedexhausted

Returns

A list object: data holds up to limit deliveries, has_more says whether another page exists and next_cursor is the value to send as cursor, or null on the last page.

200 OKA list of webhook delivery objects

Errors

400: invalid_cursor
cursor is not a value returned by this endpoint.
404: not_found
The key's project has no webhook endpoint with this id.
422: validation_error
limit is outside 1 to 100, or status is not one of the listed values.

Every endpoint can also answer the errors any request can meet: a missing key, a rate limit, a malformed body. Errors

Something missing or unclear on this page? Write to support@useinfrared.com.