Skip to content

API Reference / Steam accounts

Count a Steam account's connection events

Count an active Steam account's connection events under the ListAccountSessionEvents filter, for a figure such as the number of disconnects in the last day.

POST/steam.v1.Steam/CountAccountSessionEvents

Request body

application/jsonRequired

Request to count an account's session events under the ListAccountSessionEvents filter.

accountNamestring

Active Steam account in the authorized workspace.

filter?AccountSessionEventFilter

The same filters as ListAccountSessionEvents.

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"

Response body

application/json

Success

count?string

Matching events within the 30 days kept.

Format"int64"

curl -X POST "https://api.goldmine.to/steam.v1.Steam/CountAccountSessionEvents" \
  -H "Authorization: Bearer $CSTRADER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "accountName": "flip_eu_02",
    "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"
      ]
    }
  }'
{
  "count": "3"
}