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.
/ steam. v1. Steam/ ListConfirmationsRequest body
application/jsonRequired
Request for one page of an account's Steam mobile confirmations, optionally filtered by status.
accountNamestringSteam account name whose confirmation queue to list.
cursor?stringOpaque pagination cursor from a previous ListConfirmationsResponse. Empty for the first page.
descending?booleanOrder descending instead of ascending.
limit?integerMaximum number of confirmations to return. Server caps this at a service-defined upper bound.
Format"int32"
sortField?stringField to order the page by. Unspecified orders by creation time.
Value in"CONFIRMATION_
statuses?array<string>Optional lifecycle status set. Empty returns every status.
Value in"CONFIRMATION_"CONFIRMATION_"CONFIRMATION_"CONFIRMATION_
Response body
application/json
Success
confirmations?array<Confirmation>Full confirmations for this page.
Show attributes
accountName?stringThe Steam account this confirmation belongs to.
confirmationId?stringConfirmation identifier.
createdAt?stringWhen this confirmation was first observed.
Format"date-time"
creatorId?stringThe trade offer id or market listing id this confirmation is for.
failedAt?stringWhen the last attempt failed. Unset when no attempt failed.
Format"date-time"
failureReason?stringWhy the last attempt to accept or decline this confirmation failed. Unspecified when no attempt failed, and cleared when the confirmation resolves.
Value in"CONFIRMATION_"CONFIRMATION_"CONFIRMATION_"CONFIRMATION_"CONFIRMATION_
resolvedAt?stringWhen this confirmation was accepted, declined, or observed as vanished from the list. Unset while pending.
Format"date-time"
status?stringCurrent lifecycle state of the confirmation.
Value in"CONFIRMATION_"CONFIRMATION_"CONFIRMATION_"CONFIRMATION_
type?stringSteam confirmation type as lowercase snake_case text, for example trade or market_listing.
workspaceId?stringWorkspace the confirmation belongs to.
Format"byte" base64
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
The request was rate limited. Slow down and retry later.
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/ListConfirmations" \
-H "Authorization: Bearer $CSTRADER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"accountName": "trader_bot_01",
"statuses": [
"CONFIRMATION_STATUS_PENDING"
],
"limit": 50
}'const res = await fetch("https://api.goldmine.to/steam.v1.Steam/ListConfirmations", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.CSTRADER_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"accountName": "trader_bot_01",
"statuses": [
"CONFIRMATION_STATUS_PENDING"
],
"limit": 50
}),
});
const data = await res.json();body := strings.NewReader(`{
"accountName": "trader_bot_01",
"statuses": [
"CONFIRMATION_STATUS_PENDING"
],
"limit": 50
}`)
req, err := http.NewRequestWithContext(ctx, http.MethodPost, "https://api.goldmine.to/steam.v1.Steam/ListConfirmations", 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/ListConfirmations",
headers={"Authorization": f"Bearer {os.environ['CSTRADER_API_KEY']}"},
json={
"accountName": "trader_bot_01",
"statuses": [
"CONFIRMATION_STATUS_PENDING"
],
"limit": 50
},
)
data = res.json(){
"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="
}{
"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": "resource_exhausted",
"message": "The request was rate limited. Slow down and retry later."
}{
"code": "internal",
"message": "An internal server error occurred."
}