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

{
  "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
​
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 https://qstash.upstash.io/v1/messages/msg_123 \
  -H "Authorization: Bearer <token>"

{
  "messageId": "msg_123",
  "topicId": "tpc_123",
  "url":"https://example.com",
  "method": "POST",
  "header": {
    "My-Header": "my-value"
  },
  "body": "{\"foo\":\"bar\"}",
  "createdAt": 1620000000000
}
GET
/
v1
/
messages
/
{messageId}
curl https://qstash.upstash.io/v1/messages/msg_123 \
  -H "Authorization: Bearer <token>"

{
  "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
​
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 https://qstash.upstash.io/v1/messages/msg_123 \
  -H "Authorization: Bearer <token>"

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