List Events

This endpoint returns a list of all recent events.

GET /v1/events

curl

curl -X GET https://qstash.upstash.io/v1/events \
 -H "Authorization: Bearer <token>"

200

{
  "cursor": "1686652644442-12",
  "events": [
    {
      "id": "12345"
      "time": "1686652644442",
      "messageId": "msg_123",
      "nextDeliveryTime": "1691172945",
      "state": "delivered",
      "taskId": "98765",
      "time": "1691170945"
      "url": "https://example.com",
    }
  ]
}

Response

cursor · string

The cursor to use for pagination, if empty, there are no more pages.

events · Array<Event> · required

Show Event

error · string

only set if status is error

id · string · required

The id of the event.

messageId · string · required

The associated message id

nextDeliveryTime · int

The next scheduled time of the message

state · string · required

The state of the message at this point in time

taskId · string · required

The associated task id

time · int · required

Timestamp of this event in unix time (milliseconds)

url · string

The destination url, this is experimental and might be removed in the future

curl

curl -X GET https://qstash.upstash.io/v1/events \
 -H "Authorization: Bearer <token>"

200

{
  "cursor": "1686652644442-12",
  "events": [
    {
      "id": "12345"
      "time": "1686652644442",
      "messageId": "msg_123",
      "nextDeliveryTime": "1691172945",
      "state": "delivered",
      "taskId": "98765",
      "time": "1691170945"
      "url": "https://example.com",
    }
  ]
}