Skip to content

API Reference / Legacy proxy assignments

Get the legacy proxy assigned to an account

Returns the full proxy and assignment for a given account within a legacy pool, resolving the account's binding in one call instead of a separate ListProxyAssignments filter followed by a proxy lookup. The proxy's password is never returned.

POST/proxies.v1.Proxies/GetProxyForAccount

Request body

application/jsonRequired

Request for the legacy proxy assigned to an account within a legacy proxy pool in the caller's workspace.

accountName?string

The account whose proxy to look up. Surrounding whitespace is trimmed.

poolId?string

Opaque 16-byte identifier of the legacy proxy pool to look in, base64-encoded in JSON.

Format"byte" base64

Response body

application/json

Success

proxy?Proxy

The assigned legacy proxy, without its password.

Show attributes
createdAt?string

When the proxy was created.

Format"date-time"

deletedAt?string

When the proxy was deleted. Absent while it is live.

Format"date-time"

enabled?boolean

True when the proxy can be used. Set false by UpdateProxy or automatically when its failure rate is too high.

failureCount?string

Number of failed requests reported through the proxy over its lifetime. Drives automatic disabling.

Format"int64"

id?string

Opaque 16-byte identifier of the proxy, assigned on creation. Base64-encoded in JSON.

Format"byte" base64

ip?string

Proxy host address, an IPv4 or IPv6 address. Unique with port within the workspace.

password?string

Password for proxy authentication. Write only: accepted when the proxy is created, stored encrypted and never returned.

port?integer

Proxy TCP port, from 1 to 65535.

Format"int32"

scheme?string

Protocol used to connect to the proxy: "http", "https" or "socks5".

successCount?string

Number of successful requests reported through the proxy over its lifetime.

Format"int64"

updatedAt?string

When the proxy was last changed.

Format"date-time"

user?string

Username for proxy authentication. Absent for a proxy without authentication.

version?string

Edit counter, incremented by every change a user makes to the proxy.

Format"int64"

workspaceId?string

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

Format"byte" base64

proxyAssignment?ProxyAssignment

The legacy assignment linking the account to the proxy.

Show attributes
accountName?string

The account that uses the proxy.

createdAt?string

When the assignment was created.

Format"date-time"

deletedAt?string

When the assignment was deleted. Absent while it is live.

Format"date-time"

id?string

Opaque 16-byte identifier of the legacy assignment, assigned on creation. Base64-encoded in JSON.

Format"byte" base64

poolId?string

Opaque 16-byte identifier of the legacy proxy pool, base64-encoded in JSON.

Format"byte" base64

proxyId?string

Opaque 16-byte identifier of the assigned legacy proxy, base64-encoded in JSON.

Format"byte" base64

updatedAt?string

When the assignment was last changed.

Format"date-time"

workspaceId?string

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

Format"byte" base64

curl -X POST "https://api.goldmine.to/proxies.v1.Proxies/GetProxyForAccount" \
  -H "Authorization: Bearer $CSTRADER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "poolId": "bGVnYWN5cG9vbDAwMDEAAA==",
    "accountName": "steam_bot_01"
  }'
{
  "proxy": {
    "scheme": "http",
    "ip": "203.0.113.10",
    "port": 8080,
    "user": "legacyproxyuser",
    "id": "bGVnYWN5cHJveHkwMDEAAA==",
    "workspaceId": "AY+MHnorfD2eTxorPE1ebw==",
    "enabled": true,
    "version": "1",
    "createdAt": "2026-06-20T12:00:00Z",
    "updatedAt": "2026-06-20T12:00:00Z"
  },
  "proxyAssignment": {
    "id": "bGVnYWN5YXNzaWduMDEAAA==",
    "workspaceId": "AY+MHnorfD2eTxorPE1ebw==",
    "proxyId": "bGVnYWN5cHJveHkwMDEAAA==",
    "poolId": "bGVnYWN5cG9vbDAwMDEAAA==",
    "accountName": "steam_bot_01",
    "createdAt": "2026-06-20T12:00:00Z",
    "updatedAt": "2026-06-20T12:00:00Z"
  }
}