Skip to content

API Reference / Proxy remediations

List proxy remediation records

Returns the proxy remediation records in your workspace, optionally filtered by pool or status. Results are paginated. Pass an empty cursor for the first page and follow the returned cursor for subsequent pages.

POST/proxies.v1.Proxies/ListRemediations

Request body

application/jsonRequired

Request for one page of the endpoint remediations in the caller's workspace, optionally narrowed by status.

cursor?string

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

descending?boolean

Order descending instead of ascending.

filter?RemediationFilter

Optional filters applied before pagination.

Show attributes
poolId?string

Optional pool id to limit results to that pool's remediation records. Unset includes remediation records across all pools.

Format"byte" base64

limit?integer

Maximum number of remediation records 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"REMEDIATION_SORT_FIELD_CREATED_AT""REMEDIATION_SORT_FIELD_UPDATED_AT"

statuses?array<string>

Optional status set, the grouping dimension CountRemediations breaks down by. Empty includes every status.

Value in"REMEDIATION_STATUS_NEEDS_NEW_ENDPOINT""REMEDIATION_STATUS_ACQUIRING""REMEDIATION_STATUS_BOUND""REMEDIATION_STATUS_SYNCING""REMEDIATION_STATUS_DONE""REMEDIATION_STATUS_HALTED"

Response body

application/json

Success

nextCursor?string

Cursor to pass as cursor to fetch the next page. Empty when this is the last page.

remediations?array<ProxiesRemediation>

The remediations on this page, in the requested order.

Show attributes
accountName?string

Steam account name whose dead endpoint is being replaced.

assignmentId?string

Opaque 16-byte identifier of the account's current assignment, base64-encoded in JSON. Refreshed each time the remediation reopens.

Format"byte" base64

attempts?integer

Number of attempts to acquire an endpoint in the current episode. Capped, and reset when a new episode starts.

Format"int32"

createdAt?string

When the remediation record was created.

Format"date-time"

id?string

Opaque 16-byte identifier of the remediation record, base64-encoded in JSON.

Format"byte" base64

lastError?string

The last failure, recorded when the remediation halts so a member can see what went wrong. Absent otherwise.

newSessionId?string

Opaque 16-byte identifier of the replacement session, base64-encoded in JSON. Absent until a new endpoint is bound.

Format"byte" base64

orderReference?string

The provider's order or replacement reference, recorded once a purchase is confirmed so it is never bought twice. Absent until then.

poolId?string

Opaque 16-byte identifier of the pool of the account being repaired, base64-encoded in JSON.

Format"byte" base64

providerId?string

Opaque 16-byte identifier of the provider that owns the pool, base64-encoded in JSON. Empty for an imported pool.

Format"byte" base64

spendCents?string

Money committed to the provider in the current episode, in US cents. Reset when a new episode starts.

Format"int64"

status?string

Where the replacement stands: needs a new endpoint, acquiring one, bound to a new session, syncing, done, or halted and needing attention.

Value in"REMEDIATION_STATUS_NEEDS_NEW_ENDPOINT""REMEDIATION_STATUS_ACQUIRING""REMEDIATION_STATUS_BOUND""REMEDIATION_STATUS_SYNCING""REMEDIATION_STATUS_DONE""REMEDIATION_STATUS_HALTED"

updatedAt?string

When the remediation record last changed.

Format"date-time"

waitingReason?string

Why a remediation that needs a new endpoint is waiting rather than proceeding. Unset while it is not waiting.

Value in"REMEDIATION_WAITING_REASON_NOT_DELETED_OR_REFUSED""REMEDIATION_WAITING_REASON_NO_FREE_PROXY""REMEDIATION_WAITING_REASON_BUYING_OFF""REMEDIATION_WAITING_REASON_OVER_BUDGET""REMEDIATION_WAITING_REASON_BALANCE_SHORT""REMEDIATION_WAITING_REASON_NO_CARRIER"

workspaceId?string

Opaque 16-byte identifier of the workspace, base64-encoded in JSON.

Format"byte" base64

curl -X POST "https://api.goldmine.to/proxies.v1.Proxies/ListRemediations" \
  -H "Authorization: Bearer $CSTRADER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "limit": 50,
    "filter": {
      "poolId": "AY+MISIifMyN3T09PT09PQ=="
    }
  }'
{
  "remediations": [
    {
      "id": "AY+MJmRlZu6P/05OTk5OTg==",
      "workspaceId": "AY+MHnorfD2eTxorPE1ebw==",
      "assignmentId": "AY+MI0REf/+Kql9fX19fXw==",
      "poolId": "AY+MISIifMyN3T09PT09PQ==",
      "accountName": "steam_bot_01",
      "status": "REMEDIATION_STATUS_HALTED",
      "attempts": 3,
      "spendCents": "0",
      "lastError": "no healthy candidate available",
      "createdAt": "2026-06-28T09:00:00Z",
      "updatedAt": "2026-06-28T09:05:00Z"
    }
  ],
  "nextCursor": "eyJvZmZzZXQiOjUwfQ=="
}