API Reference / Steam chat
List chat messages in a conversation
Return a paginated, newest-first slice of the chat messages exchanged between the account and a specific Steam user.
/ steam. v1. Steam/ ListChatMessagesRequest body
application/jsonRequired
Request for one page of the messages exchanged between one workspace account and one Steam user, newest first.
accountNamestringSteam account name whose conversation to read.
cursor?stringOpaque pagination cursor from a previous ListChatMessagesResponse. Empty for the first page.
limit?integerMaximum number of messages to return. Server caps this at a service-defined upper bound.
Format"int32"
partnerSteamIdstringThe other side of the conversation's 64-bit SteamID.
Response body
application/json
Success
messages?array<ChatMessage>Messages in the conversation, newest first.
Show attributes
accountName?stringThe Steam account this message belongs to.
body?stringThe message text.
createdAt?stringWhen this record was stored by the platform.
Format"date-time"
deliveryStatus?stringDelivery state of an outbound message. CONFIRMED means Steam accepted it. Unspecified on inbound messages.
Value in"CHAT_"CHAT_"CHAT_"CHAT_"CHAT_"CHAT_"CHAT_
direction?stringWhether the account sent or received this message.
Value in"CHAT_"CHAT_
id?stringChat message identifier.
Format"int64"
ordinal?integerSteam's per-conversation, per-second tiebreaker for messages sharing the same sent_at.
Format"int32"
partnerSteamId?stringThe 64-bit SteamID of the other side of the conversation.
requestId?stringThe accepted chat send request that produced this live outbound event, when known.
sentAt?stringSteam's own server timestamp for when the message was sent.
Format"date-time"
workspaceId?stringWorkspace the message belongs to.
Format"byte" base64
nextCursor?stringCursor to pass to fetch the next page. Empty when there are no more results.
application/json
The request was malformed, such as a missing required field or an unparseable cursor.
codestringThe Connect error code, such as "not_found".
details?array<object>Optional machine-readable error details.
messagestringA human-readable description of the error.
application/json
The request lacks a valid API key in the Authorization header.
codestringThe Connect error code, such as "not_found".
details?array<object>Optional machine-readable error details.
messagestringA human-readable description of the error.
application/json
The API key is not allowed to perform this action on this workspace.
codestringThe Connect error code, such as "not_found".
details?array<object>Optional machine-readable error details.
messagestringA human-readable description of the error.
application/json
The requested resource does not exist in this workspace.
codestringThe Connect error code, such as "not_found".
details?array<object>Optional machine-readable error details.
messagestringA human-readable description of the error.
application/json
The request was rate limited. Slow down and retry later.
codestringThe Connect error code, such as "not_found".
details?array<object>Optional machine-readable error details.
messagestringA human-readable description of the error.
application/json
An internal server error occurred.
codestringThe Connect error code, such as "not_found".
details?array<object>Optional machine-readable error details.
messagestringA human-readable description of the error.
curl -X POST "https://api.goldmine.to/steam.v1.Steam/ListChatMessages" \
-H "Authorization: Bearer $CSTRADER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"accountName": "trader_bot_01",
"partnerSteamId": "76561198044443322",
"limit": 50
}'const res = await fetch("https://api.goldmine.to/steam.v1.Steam/ListChatMessages", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.CSTRADER_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"accountName": "trader_bot_01",
"partnerSteamId": "76561198044443322",
"limit": 50
}),
});
const data = await res.json();body := strings.NewReader(`{
"accountName": "trader_bot_01",
"partnerSteamId": "76561198044443322",
"limit": 50
}`)
req, err := http.NewRequestWithContext(ctx, http.MethodPost, "https://api.goldmine.to/steam.v1.Steam/ListChatMessages", body)
if err != nil {
return err
}
req.Header.Set("Authorization", "Bearer "+os.Getenv("CSTRADER_API_KEY"))
req.Header.Set("Content-Type", "application/json")
res, err := http.DefaultClient.Do(req)import os, requests
res = requests.post(
"https://api.goldmine.to/steam.v1.Steam/ListChatMessages",
headers={"Authorization": f"Bearer {os.environ['CSTRADER_API_KEY']}"},
json={
"accountName": "trader_bot_01",
"partnerSteamId": "76561198044443322",
"limit": 50
},
)
data = res.json(){
"messages": [
{
"id": "81923",
"accountName": "trader_bot_01",
"workspaceId": "AY86PB0ufwCKGyw9Tl9gcQ==",
"partnerSteamId": "76561198044443322",
"direction": "CHAT_MESSAGE_DIRECTION_OUTBOUND",
"body": "Hi, your item has been sent!",
"sentAt": "2026-06-29T11:52:00Z",
"createdAt": "2026-06-29T11:52:01Z"
}
],
"nextCursor": "eyJpZCI6ODE5MjN9"
}{
"code": "invalid_argument",
"message": "The request was malformed, such as a missing required field or an unparseable cursor."
}{
"code": "unauthenticated",
"message": "The request lacks a valid API key in the Authorization header."
}{
"code": "permission_denied",
"message": "The API key is not allowed to perform this action on this workspace."
}{
"code": "not_found",
"message": "The requested resource does not exist in this workspace."
}{
"code": "resource_exhausted",
"message": "The request was rate limited. Slow down and retry later."
}{
"code": "internal",
"message": "An internal server error occurred."
}