Skip to content

API Reference / Steam confirmations

List mobile confirmations

Return a paginated list of an account's Steam mobile confirmations, optionally filtered by status. Each entry links to the trade offer or market listing it confirms.

POST/steam.v1.Steam/ListConfirmations

Request body

application/jsonRequired

Request for one page of an account's Steam mobile confirmations, optionally filtered by status.

accountNamestring

Steam account name whose confirmation queue to list.

cursor?string

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

descending?boolean

Order descending instead of ascending.

limit?integer

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

Format"int32"

sortField?string

Field to order the page by. Unspecified orders by creation time.

Value in"CONFIRMATION_SORT_FIELD_CREATED_AT"

statuses?array<string>

Optional lifecycle status set. Empty returns every status.

Value in"CONFIRMATION_STATUS_PENDING""CONFIRMATION_STATUS_ACCEPTED""CONFIRMATION_STATUS_DECLINED""CONFIRMATION_STATUS_GONE"

Response body

application/json

Success

confirmations?array<Confirmation>

Full confirmations for this page.

Show attributes
accountName?string

The Steam account this confirmation belongs to.

confirmationId?string

Confirmation identifier.

createdAt?string

When this confirmation was first observed.

Format"date-time"

creatorId?string

The trade offer id or market listing id this confirmation is for.

failedAt?string

When the last attempt failed. Unset when no attempt failed.

Format"date-time"

failureReason?string

Why the last attempt to accept or decline this confirmation failed. Unspecified when no attempt failed, and cleared when the confirmation resolves.

Value in"CONFIRMATION_FAILURE_REASON_NO_SESSION""CONFIRMATION_FAILURE_REASON_NO_WEB_SESSION""CONFIRMATION_FAILURE_REASON_NO_IDENTITY_SECRET""CONFIRMATION_FAILURE_REASON_RATE_LIMITED""CONFIRMATION_FAILURE_REASON_STEAM_REJECTED"

resolvedAt?string

When this confirmation was accepted, declined, or observed as vanished from the list. Unset while pending.

Format"date-time"

status?string

Current lifecycle state of the confirmation.

Value in"CONFIRMATION_STATUS_PENDING""CONFIRMATION_STATUS_ACCEPTED""CONFIRMATION_STATUS_DECLINED""CONFIRMATION_STATUS_GONE"

type?string

Steam confirmation type as lowercase snake_case text, for example trade or market_listing.

workspaceId?string

Workspace the confirmation 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/ListConfirmations" \
  -H "Authorization: Bearer $CSTRADER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "accountName": "trader_bot_01",
    "statuses": [
      "CONFIRMATION_STATUS_PENDING"
    ],
    "limit": 50
  }'
{
  "confirmations": [
    {
      "confirmationId": "14258039472",
      "accountName": "trader_bot_01",
      "workspaceId": "AY86PB0ufwCKGyw9Tl9gcQ==",
      "type": "trade",
      "creatorId": "6483920185",
      "status": "CONFIRMATION_STATUS_PENDING",
      "createdAt": "2026-06-29T11:31:00Z"
    }
  ],
  "nextCursor": "eyJpZCI6IjE0MjU4MDM5NDcyIn0="
}