API Reference / Proxy sessions
Count proxy sessions
Returns the number of proxy sessions in your workspace matching the same filter ListSessions takes, so a list page can render a count without loading and counting every row.
/ proxies. v1. Proxies/ CountSessionsRequest body
application/jsonRequired
Request for the number of proxy sessions in the caller's workspace matching a filter.
filter?SessionFilterThe same filter as ListSessions.
Show attributes
assigned?booleanTrue selects only sessions with at least one live account assignment, false only sessions with none. Unset includes both.
cities?array<string>Exit cities to include, as the English city names the sessions report in health.exit_city, OR within the field. The empty string selects sessions whose city is not known. Empty includes sessions in every city.
countries?array<string>Exit countries to include, as upper-case ISO 3166-1 alpha-2 codes, OR within the field. A session's country is health.exit_country when observed, otherwise the provider's country. Empty includes sessions in every country and sessions whose country is not known.
enabled?booleanTrue selects only enabled sessions, false only disabled sessions. Unset includes sessions regardless of enabled state.
healths?array<string>Health states to include. Empty includes sessions in every state.
Value in"SESSION_"SESSION_"SESSION_
poolId?stringOptional pool id to limit results to a single pool. Unset includes sessions across all pools.
Format"byte" base64
query?stringLiteral case-insensitive substring of the session's host, slot number or an assigned account name. Absent or empty matches every session.
Response body
application/json
Success
count?integerNumber of live sessions matching the filter.
Format"int32"
application/json
The request was malformed, such as a missing required field or an unparseable cursor. The request cannot be carried out in the current system state.
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 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.
application/json
The service is temporarily unavailable. Retry with backoff.
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/proxies.v1.Proxies/CountSessions" \
-H "Authorization: Bearer $CSTRADER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"filter": {
"poolId": "AY+MISIifMyN3T09PT09PQ=="
}
}'const res = await fetch("https://api.goldmine.to/proxies.v1.Proxies/CountSessions", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.CSTRADER_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"filter": {
"poolId": "AY+MISIifMyN3T09PT09PQ=="
}
}),
});
const data = await res.json();body := strings.NewReader(`{
"filter": {
"poolId": "AY+MISIifMyN3T09PT09PQ=="
}
}`)
req, err := http.NewRequestWithContext(ctx, http.MethodPost, "https://api.goldmine.to/proxies.v1.Proxies/CountSessions", 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/proxies.v1.Proxies/CountSessions",
headers={"Authorization": f"Bearer {os.environ['CSTRADER_API_KEY']}"},
json={
"filter": {
"poolId": "AY+MISIifMyN3T09PT09PQ=="
}
},
)
data = res.json(){
"count": 3
}{
"code": "failed_precondition",
"message": "The request cannot be carried out in the current system state."
}{
"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": "resource_exhausted",
"message": "The request was rate limited. Slow down and retry later."
}{
"code": "internal",
"message": "An internal server error occurred."
}{
"code": "unavailable",
"message": "The service is temporarily unavailable. Retry with backoff."
}