Skip to content

API Reference / Steam chat

Get an account's owned Steam emoticons

Read the last known actual chat emoticon entitlements observed by the account's normal Steam session. Observation timestamps distinguish a successful empty list from an unobserved or stale snapshot. This read does not contact Steam or force a refresh.

POST/steam.v1.Steam/GetEmoticonList

Request body

application/jsonRequired

Request for the chat emoticons an account owns, as last observed by its Steam session. Does not contact Steam.

accountNamestring

Steam account whose chat emoticon snapshot to read.

Response body

application/json

Success

emoticonList?EmoticonList

The account's last known entitlement snapshot, including observation and refresh state.

Show attributes
accountName?string

Account whose entitlements were observed.

emoticons?array<Emoticon>

Actual returned entitlements. Empty with observed_at is an observed empty list. Empty without it is unknown.

Show attributes
appId?integer

App that supplies the emoticon when reported by Steam.

Format"int32"

count?integer

Steam reported owned count. A zero count can still identify an entitled default emoticon.

Format"int32"

iconUrl?string

Valve hosted emoticon icon for a supported token. Absent when no safe supported image token is available.

lastUsedAt?string

Last use reported by Steam, absent when never used.

Format"date-time"

name?string

The exact Steam token, normally including outer colons. This name is authoritative for chat composition.

receivedAt?string

Receipt time reported by Steam, absent for an unreported or default entitlement.

Format"date-time"

useCount?integer

Usage count reported by Steam.

Format"int32"

lastAttemptAt?string

Last normal session refresh attempt, whether successful or failed.

Format"date-time"

lastRefreshFailed?boolean

The most recent normal refresh failed. Any prior observed entitlements and their timestamp remain available as cached data.

observedAt?string

Last successful Steam observation. Absent when no successful snapshot has been observed.

Format"date-time"

workspaceId?string

Workspace that owns the account.

Format"byte" base64

curl -X POST "https://api.goldmine.to/steam.v1.Steam/GetEmoticonList" \
  -H "Authorization: Bearer $CSTRADER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "accountName": "flip_eu_02"
  }'
{
  "emoticonList": {
    "accountName": "flip_eu_02",
    "emoticons": [
      {
        "appId": 730,
        "count": 3,
        "iconUrl": "https://community.cloudflare.steamstatic.com/economy/image/redline-ft",
        "lastUsedAt": "2026-11-03T16:10:00Z",
        "name": "Rifle accounts",
        "receivedAt": "2026-11-03T16:10:00Z",
        "useCount": 3
      }
    ],
    "lastAttemptAt": "2026-11-03T16:10:00Z",
    "lastRefreshFailed": false,
    "observedAt": "2026-11-03T16:10:00Z",
    "workspaceId": "AY86PB0ufwCKGyw9Tl9gcQ=="
  }
}