Skip to content

API Reference / Proxy sessions

List proxies no longer provided

Returns the proxies in your workspace that their provider no longer provides, newest first by default: each with its address, when it stopped, the last account that used it and where that account is now. A proxy the provider stopped listing, or one the provider reports ended that fails its checks, is listed here once no account is on it, and is no longer counted, listed or checked as one of its pool's proxies. Results are paginated. Pass an empty cursor for the first page and follow the returned cursor for subsequent pages.

POST/proxies.v1.Proxies/ListEndedSessions

Request body

application/jsonRequired

Request for one page of the proxies in the caller's workspace that their provider no longer provides.

cursor?string

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

descending?boolean

Order descending instead of ascending. The provider page shows the newest first.

filter?EndedSessionFilter

Optional filters applied before pagination.

Show attributes
poolId?string

Optional pool id to limit results to one pool.

Format"byte" base64

providerId?string

Optional provider id to limit results to one provider's proxies.

Format"byte" base64

limit?integer

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

Format"int32"

sortField?string

Field to order the page by. Unspecified orders by when the proxy stopped being provided.

Value in"ENDED_SESSION_SORT_FIELD_ENDED_AT"

Response body

application/json

Success

nextCursor?string

Cursor to pass to fetch the next page. Empty when there are no more results.

sessions?array<EndedSession>

The proxies for this page, ordered by the requested sort.

Show attributes
endedAt?string

When it stopped being provided: the end the provider reports for it when it gives one, otherwise when the provider was first seen no longer listing it.

Format"date-time"

host?string

The proxy's host.

lastAccountName?string

The last account that sent traffic through it, from the usage record. Empty when no account ever used it.

lastAccountNow?EndedSessionAccountPlacement

The proxy that account is on now. Absent when the account has no proxy or no account ever used this one.

Show attributes
host?string

The host of that proxy.

port?integer

The port of that proxy.

Format"int32"

sessionId?string

Opaque 16-byte identifier of the session the account is on now, base64-encoded in JSON.

Format"byte" base64

poolId?string

Opaque 16-byte identifier of the pool it was in, base64-encoded in JSON.

Format"byte" base64

port?integer

The proxy's port.

Format"int32"

providerId?string

Opaque 16-byte identifier of its provider, base64-encoded in JSON. Empty for an imported proxy.

Format"byte" base64

sessionId?string

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

Format"byte" base64

curl -X POST "https://api.goldmine.to/proxies.v1.Proxies/ListEndedSessions" \
  -H "Authorization: Bearer $CSTRADER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "limit": 50,
    "filter": {
      "providerId": "AY+MIBEReqqLuywsLCwsLA=="
    }
  }'
{
  "sessions": [
    {
      "sessionId": "AY+MIjMzfu6P/05OTk5OTg==",
      "poolId": "AY+MISIifMyN3T09PT09PQ==",
      "providerId": "AY+MIBEReqqLuywsLCwsLA==",
      "host": "203.0.113.10",
      "port": 62903,
      "endedAt": "2026-11-11T13:14:08Z",
      "lastAccountName": "trader-1",
      "lastAccountNow": {
        "sessionId": "AY+MJTQ0NDQ0NDQ0NDQ0NA==",
        "host": "203.0.113.24",
        "port": 62711
      }
    }
  ],
  "nextCursor": ""
}