List events

The last 30 days of events, newest first, in the shape a webhook receives them. Use it to catch up after missing deliveries.

Needs a key with the messages:read scope. Keys and scopes

Query parameters

• typestring

  Only these types, comma-separated, such as message.received,message.failed.

• sincetimestamp

  Only events at or after this time. Events are kept 30 days.

• 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/events" \
  -H "Authorization: Bearer $BLUEBOT_API_KEY"

Response

200: A page of events.

• object"list"required
• dataarray of Eventrequired
  Show its 7 fieldsHide its fields

  • idstringrequired

    The event id. A webhook delivery sends it as webhook-id, the same on every retry, so a receiver can skip one it already has.

    Starts with evt_.

  • object"event"required
  • 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.

  • api_versionstringrequired

    The payload version: the one the receiving webhook was made with.

  • timestamptimestamprequired

    When it happened.

  • testtrue

    Present, and true, only on a test event from Send test event or POST /v1/webhooks/{id}/test. Its data is the catalog’s example, with example ids that match nothing on your account. Real events never have it.

  • datamap of anyrequired

    The record as the API returned it at the time. Each type’s shape is in the event catalog.

• 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": "evt_1Hq2LxW9cVbN3mKpRtYs0a",
      "object": "event",
      "type": "message.received",
      "api_version": "2026-11-13",
      "timestamp": "2026-11-13T19:41:00.000Z",
      "data": {
        "id": "msg_2Bf8QzD4kJmA6nXwEuTr1c",
        "object": "message",
        "direction": "in",
        "state": "received",
        "to": "+15555550100",
        "from": "+15555550123",
        "chat_id": null,
        "contact_id": "ct_1Hq2LxW9cVbN3mKpRtYs0a",
        "conversation_id": "conv_1Hq2LxW9cVbN3mKpRtYs0a",
        "text": "Perfect, see you there!",
        "text_deleted": false,
        "files": [],
        "service_requested": "auto",
        "service": "imessage",
        "sms_retry": false,
        "source": "mac",
        "source_ref": null,
        "metadata": {},
        "hold": null,
        "send_at": null,
        "expires_at": null,
        "failure": null,
        "cancel_reason": null,
        "resolution": null,
        "resolved_at": null,
        "resent_message_id": null,
        "reply_to_id": null,
        "reactions": [],
        "edited_at": null,
        "unsent_at": null,
        "created_at": "2026-11-13T19:44:12.000Z",
        "queued_at": null,
        "sending_at": null,
        "sent_at": null,
        "delivered_at": null,
        "read_at": null,
        "failed_at": null,
        "unconfirmed_at": null,
        "expired_at": null,
        "canceled_at": null,
        "received_at": "2026-11-13T19:44:10.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