List deliveries

What BlueBot tried to deliver to this webhook in the last 30 days, newest first, with each answer’s status.

Needs a key with the webhooks:manage scope. Keys and scopes

Path parameters

• idstringrequired

  The webhook’s id.

  Starts with wh_.

Query parameters

• statestring

  One of pending, delivered, gave_up, dropped.

• limitinteger

  How many to return, 1 to 100. Default 25.

  1 to 100.Default 25.

• cursorstring

  The next_cursor of the page before. Leave it out for the first page.

  Up to 200 characters.

Example

curl "https://usebluebot.com/api/v1/webhooks/wh_1Hq2LxW9cVbN3mKpRtYs0a/deliveries" \
  -H "Authorization: Bearer $BLUEBOT_API_KEY"

Response

200: A page of deliveries.

• object"list"required
• dataarray of WebhookDeliveryrequired
  Show its 16 fieldsHide its fields

  • idstringrequired

    A dlv_ id.

    Starts with dlv_.

  • object"webhook_delivery"required
  • webhook_idstringrequired

    A wh_ id.

    Starts with wh_.

  • event_idstringrequired

    A evt_ id.

    Starts with evt_.

  • event_typestringrequired

    One of message.queued, message.sent, message.delivered, message.read, message.failed, message.unconfirmed, message.expired, message.canceled, message.received, message.edited, message.unsent, reaction.added, reaction.removed, chat.created, contact.created, contact.stopped, contact.unstopped, sequence.completed, broadcast.completed, automation.matched, device.online, device.offline, device.check_failed.

  • testbooleanrequired

    True for an example sent with POST /v1/webhooks/{id}/test.

  • statestringrequired

    pending (trying, or waiting to try again), delivered, gave_up after the last retry, or dropped.

    One of pending, delivered, gave_up, dropped.

  • attemptsintegerrequired
  • last_statusinteger or nullrequired

    The HTTP status of the last try.

  • last_errorstring or nullrequired

    Why the last try failed, when there was no answer.

  • last_duration_msinteger or nullrequired
  • last_response_bodystring or nullrequired

    The first 2 KB of what your endpoint answered on the last try, as text. Null when it answered with no body or not at all.

  • next_attempt_attimestamp or nullrequired

    When it is tried next, while pending.

  • delivered_attimestamp or nullrequired

    When a 2xx answered it.

  • replay_ofstring or nullrequired

    The delivery this one repeats, for a replay.

    Starts with dlv_.

  • created_attimestamprequired

    When it was made.

• has_morebooleanrequired

  Whether another page follows.

• next_cursorstring or nullrequired

  Send as cursor for the next page; null on the last.

{
  "object": "list",
  "data": [
    {
      "id": "dlv_1Hq2LxW9cVbN3mKpRtYs0a",
      "object": "webhook_delivery",
      "webhook_id": "wh_1Hq2LxW9cVbN3mKpRtYs0a",
      "event_id": "evt_1Hq2LxW9cVbN3mKpRtYs0a",
      "event_type": "message.received",
      "test": false,
      "state": "delivered",
      "attempts": 1,
      "last_status": 200,
      "last_error": null,
      "last_duration_ms": 182,
      "last_response_body": "{\"ok\":true}",
      "next_attempt_at": null,
      "delivered_at": "2026-11-13T19:44:13.000Z",
      "replay_of": null,
      "created_at": "2026-11-13T19:44:12.000Z"
    }
  ],
  "has_more": false,
  "next_cursor": null
}

Errors

Every refusal has the same envelope and a page of its own. These are the ones this operation can give.

Try it