Skip to content

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.

POST/steam.v1.Steam/ListChatMessages

Request body

application/jsonRequired

Request for one page of the messages exchanged between one workspace account and one Steam user, newest first.

accountNamestring

Steam account name whose conversation to read.

cursor?string

Opaque pagination cursor from a previous ListChatMessagesResponse. Empty for the first page.

limit?integer

Maximum number of messages to return. Server caps this at a service-defined upper bound.

Format"int32"

partnerSteamIdstring

The 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?string

The Steam account this message belongs to.

body?string

The message text.

createdAt?string

When this record was stored by the platform.

Format"date-time"

deliveryStatus?string

Delivery state of an outbound message. CONFIRMED means Steam accepted it. Unspecified on inbound messages.

Value in"CHAT_SEND_OUTCOME_STATUS_NO_SESSION""CHAT_SEND_OUTCOME_STATUS_RATE_LIMITED""CHAT_SEND_OUTCOME_STATUS_INVALID_RECIPIENT""CHAT_SEND_OUTCOME_STATUS_REJECTED""CHAT_SEND_OUTCOME_STATUS_UNKNOWN""CHAT_SEND_OUTCOME_STATUS_CONFIRMED""CHAT_SEND_OUTCOME_STATUS_STEAM_THROTTLED"

direction?string

Whether the account sent or received this message.

Value in"CHAT_MESSAGE_DIRECTION_INBOUND""CHAT_MESSAGE_DIRECTION_OUTBOUND"

id?string

Chat message identifier.

Format"int64"

ordinal?integer

Steam's per-conversation, per-second tiebreaker for messages sharing the same sent_at.

Format"int32"

partnerSteamId?string

The 64-bit SteamID of the other side of the conversation.

requestId?string

The accepted chat send request that produced this live outbound event, when known.

sentAt?string

Steam's own server timestamp for when the message was sent.

Format"date-time"

workspaceId?string

Workspace the message belongs to.

Format"byte" base64

nextCursor?string

Cursor to pass to fetch the next page. Empty when there are no more results.

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
  }'
{
  "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"
}