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.
/ steam. v1. Steam/ ListAccountSessionEventsRequest body
application/jsonRequired
Request for one page of an account's session events.
accountNamestringActive Steam account in the authorized workspace.
cursor?stringOpaque pagination cursor from a previous ListAccountSessionEventsResponse. Empty for the first page.
descending?booleanOrder descending (newest first) instead of ascending. Restart pagination when changing direction.
filter?AccountSessionEventFilterOptional filters applied before pagination. Restart pagination when changing the filter.
Show attributes
occurredBefore?stringExclusive upper bound on occurred_at.
Format"date-time"
occurredFrom?stringInclusive 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_"SESSION_"SESSION_"SESSION_"SESSION_"SESSION_"SESSION_"SESSION_"SESSION_"SESSION_
types?array<string>Event types to include, OR within the field. Empty includes every type.
Value in"ACCOUNT_"ACCOUNT_"ACCOUNT_"ACCOUNT_"ACCOUNT_"ACCOUNT_
limit?integerMaximum number of events to return: default 50, at most 200. A larger value is invalid.
Format"int32"
sortField?stringField to order the page by. Unspecified orders by occurred_at. Unknown numeric values are invalid.
Value in"ACCOUNT_
Response body
application/json
Success
events?array<AccountSessionEvent>Events for this page in the requested order.
Show attributes
accountName?stringThe Steam account the event happened to.
detail?stringPlain 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?stringNo 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?stringEvent identifier, a UUID.
Format"byte" base64
occurredAt?stringWhen it happened.
Format"date-time"
proxyPoolId?stringOpaque 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?stringWhy, 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_"SESSION_"SESSION_"SESSION_"SESSION_"SESSION_"SESSION_"SESSION_"SESSION_"SESSION_
type?stringWhat happened.
Value in"ACCOUNT_"ACCOUNT_"ACCOUNT_"ACCOUNT_"ACCOUNT_"ACCOUNT_
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
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/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"
}'const res = await fetch("https://api.goldmine.to/steam.v1.Steam/ListAccountSessionEvents", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.CSTRADER_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"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"
}),
});
const data = await res.json();body := strings.NewReader(`{
"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"
}`)
req, err := http.NewRequestWithContext(ctx, http.MethodPost, "https://api.goldmine.to/steam.v1.Steam/ListAccountSessionEvents", 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/ListAccountSessionEvents",
headers={"Authorization": f"Bearer {os.environ['CSTRADER_API_KEY']}"},
json={
"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"
},
)
data = res.json(){
"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": ""
}{
"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": "internal",
"message": "An internal server error occurred."
}