Get Message

This endpoint returns the complete message with the given ID.

GET https://qstash.upstash.io/v1/messages/{messageId}

Try it

curl

curl https://qstash.upstash.io/v1/messages/msg_123 \
  -H "Authorization: Bearer <token>"

200

{
  "messageId": "msg_123",
  "topicId": "tpc_123",
  "url":"https://example.com",
  "method": "POST",
  "header": {
    "My-Header": "my-value"
  },
  "body": "{\"foo\":\"bar\"}",
  "createdAt": 1620000000000
}

Request

messageId · string · required

The unique id of the message.

Response

body · string

Base64 encoded request body

createdAt · int · required

The time when the message was created in milliseconds.

destinationType · string · required

Either topic or url

endpointId · string

The endpoint Id the message was sent to. Only available if the message was sent to an endpoint.

header · Record<string, string>

The HTTP headers sent to your API.

messageId · string

The unique message Id

scheduleId · string

The unique schedule Id

settings · Settings

Show Settings

deadline · int

The time at which message should be delivered at the latest.

delay · int

The delay in seconds before the message is delivered.

notBefore · int

The time before which the message should not be delivered.

retries · int

The number of retries that should be attempted in case of delivery failure.

topicName · string

The topic name the message was sent to

Only available if the message was sent to a topic.

topicName · string

The topic Name the message was sent to

Only available if the message was sent to a topic.

This might be outdated if you have since changed the topic name. In that case, please rely on the topic id instead because it is guaranteed to be consistent.

url · string

The url where this message is being sent to.

curl

curl https://qstash.upstash.io/v1/messages/msg_123 \
  -H "Authorization: Bearer <token>"

200

{
  "messageId": "msg_123",
  "topicId": "tpc_123",
  "url":"https://example.com",
  "method": "POST",
  "header": {
    "My-Header": "my-value"
  },
  "body": "{\"foo\":\"bar\"}",
  "createdAt": 1620000000000
}