Skip to content

API Reference / Steam accounts

List a Steam account's connection events

Return a paginated list of what happened to an active Steam account's connection over the last 30 days: when it came online, when it went offline and why, sign-ins held back, proxy changes and errors. Filter by type, reason and time. Sort by time either way. Never contacts Steam.

POST/steam.v1.Steam/ListAccountSessionEvents

Request body

application/jsonRequired

Request for one page of an account's session events.

accountNamestring

Active Steam account in the authorized workspace.

cursor?string

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

descending?boolean

Order descending (newest first) instead of ascending. Restart pagination when changing direction.

filter?AccountSessionEventFilter

Optional filters applied before pagination. Restart pagination when changing the filter.

Show attributes
occurredBefore?string

Exclusive upper bound on occurred_at.

Format"date-time"

occurredFrom?string

Inclusive lower bound on occurred_at.

Format"date-time"

reasons?array<string>

Reasons to include, OR within the field. Empty includes every event, with or without a reason.

Value in"SESSION_ERROR_REASON_PROXY_NOT_ASSIGNED""SESSION_ERROR_REASON_PROXY_POOL_UNAVAILABLE""SESSION_ERROR_REASON_PROXY_UNREACHABLE""SESSION_ERROR_REASON_PROXY_AUTHENTICATION_FAILED""SESSION_ERROR_REASON_CREDENTIALS_REJECTED""SESSION_ERROR_REASON_ACCOUNT_RESTRICTED""SESSION_ERROR_REASON_LOGIN_THROTTLED""SESSION_ERROR_REASON_STEAM_UNAVAILABLE""SESSION_ERROR_REASON_WEB_SESSION_FAILED""SESSION_ERROR_REASON_INTERNAL"

types?array<string>

Event types to include, OR within the field. Empty includes every type.

Value in"ACCOUNT_SESSION_EVENT_TYPE_CONNECTED""ACCOUNT_SESSION_EVENT_TYPE_DISCONNECTED""ACCOUNT_SESSION_EVENT_TYPE_LOGIN_DEFERRED""ACCOUNT_SESSION_EVENT_TYPE_PROXY_CHANGED""ACCOUNT_SESSION_EVENT_TYPE_ERROR""ACCOUNT_SESSION_EVENT_TYPE_TRADE_HOLD"

limit?integer

Maximum number of events to return: default 50, at most 200. A larger value is invalid.

Format"int32"

sortField?string

Field to order the page by. Unspecified orders by occurred_at. Unknown numeric values are invalid.

Value in"ACCOUNT_SESSION_EVENT_SORT_FIELD_OCCURRED_AT"

Response body

application/json

Success

events?array<AccountSessionEvent>

Events for this page in the requested order.

Show attributes
accountName?string

The Steam account the event happened to.

detail?string

Plain note on the cause for an operator: Steam's result name, a fixed message for a connection failure, what a deferred sign-in waits for, or why the platform stopped the session. Never an error's raw text or a proxy address. Show customers type and reason, not this. Empty when there is nothing to add.

egressIp?string

No longer set. It held the host of the proxy address the account dialled, which can be an internal address. Read proxy_pool_id instead.

id?string

Event identifier, a UUID.

Format"byte" base64

occurredAt?string

When it happened.

Format"date-time"

proxyPoolId?string

Opaque 16-byte identifier of the proxies pool the account reached Steam through, on a connect. Look its name up with the proxies service (ProxiesPool.name). Unset on other events and on connects recorded before it was kept.

Format"byte" base64

reason?string

Why, for a disconnect, a deferred sign-in or an error. Unspecified when there is no typed reason: a connect, a proxy change, or a disconnect the platform made on purpose (detail says which).

Value in"SESSION_ERROR_REASON_PROXY_NOT_ASSIGNED""SESSION_ERROR_REASON_PROXY_POOL_UNAVAILABLE""SESSION_ERROR_REASON_PROXY_UNREACHABLE""SESSION_ERROR_REASON_PROXY_AUTHENTICATION_FAILED""SESSION_ERROR_REASON_CREDENTIALS_REJECTED""SESSION_ERROR_REASON_ACCOUNT_RESTRICTED""SESSION_ERROR_REASON_LOGIN_THROTTLED""SESSION_ERROR_REASON_STEAM_UNAVAILABLE""SESSION_ERROR_REASON_WEB_SESSION_FAILED""SESSION_ERROR_REASON_INTERNAL"

type?string

What happened.

Value in"ACCOUNT_SESSION_EVENT_TYPE_CONNECTED""ACCOUNT_SESSION_EVENT_TYPE_DISCONNECTED""ACCOUNT_SESSION_EVENT_TYPE_LOGIN_DEFERRED""ACCOUNT_SESSION_EVENT_TYPE_PROXY_CHANGED""ACCOUNT_SESSION_EVENT_TYPE_ERROR""ACCOUNT_SESSION_EVENT_TYPE_TRADE_HOLD"

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/ListAccountSessionEvents" \
  -H "Authorization: Bearer $CSTRADER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "accountName": "flip_eu_02",
    "cursor": "",
    "descending": false,
    "filter": {
      "occurredBefore": "2026-11-03T16:10:00Z",
      "occurredFrom": "2026-11-03T16:10:00Z",
      "reasons": [
        "SESSION_ERROR_REASON_PROXY_NOT_ASSIGNED"
      ],
      "types": [
        "ACCOUNT_SESSION_EVENT_TYPE_CONNECTED"
      ]
    },
    "limit": 50,
    "sortField": "ACCOUNT_SESSION_EVENT_SORT_FIELD_OCCURRED_AT"
  }'
{
  "events": [
    {
      "accountName": "flip_eu_02",
      "detail": "example",
      "egressIp": "example",
      "id": "AY86PB0ufwCKGyw9Tl9gcQ==",
      "occurredAt": "2026-11-03T16:10:00Z",
      "proxyPoolId": "AY86PB0ufwCKGyw9Tl9gcQ==",
      "reason": "SESSION_ERROR_REASON_PROXY_NOT_ASSIGNED",
      "type": "ACCOUNT_SESSION_EVENT_TYPE_CONNECTED"
    }
  ],
  "nextCursor": ""
}