Sessions
List proxy sessions
Returns the proxy sessions in your workspace, fully hydrated with their endpoint details and latest health verdict, optionally limited to a single pool. Results are paginated; pass an empty cursor for the first page and follow the returned cursor for subsequent pages.
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://loading/proxies.v1.Proxies/ListSessions" \ -H "Content-Type: application/json" \ -d '{ "limit": 50, "poolId": "AY+MISIifMyN3T09PT09PQ==" }'{
"sessions": [
{
"id": "AY+MIjMzfu6P/05OTk5OTg==",
"workspaceId": "AY+MHnorfD2eTxorPE1ebw==",
"poolId": "AY+MISIifMyN3T09PT09PQ==",
"providerId": "AY+MIBEReqqLuywsLCwsLA==",
"token": "sess-abc123",
"scheme": "http",
"host": "203.0.113.10",
"port": 8080,
"username": "user-018f",
"enabled": true,
"version": "2",
"createdAt": "2026-06-20T12:00:00Z",
"updatedAt": "2026-06-29T09:00:00Z",
"health": {
"sessionId": "AY+MIjMzfu6P/05OTk5OTg==",
"workspaceId": "AY+MHnorfD2eTxorPE1ebw==",
"healthy": true,
"latencyMs": 42,
"consecutiveFailures": 0,
"lastSuccessAt": "2026-06-29T09:05:00Z",
"probedAt": "2026-06-29T09:05:00Z"
}
},
{
"id": "AY+MJTQ0NDQ0NDQ0NDQ0NA==",
"workspaceId": "AY+MHnorfD2eTxorPE1ebw==",
"poolId": "AY+MISIifMyN3T09PT09PQ==",
"providerId": "AY+MIBEReqqLuywsLCwsLA==",
"token": "7",
"enabled": true,
"version": "1",
"createdAt": "2026-06-30T14:00:00Z",
"updatedAt": "2026-06-30T14:00:00Z",
"health": {
"sessionId": "AY+MJTQ0NDQ0NDQ0NDQ0NA==",
"workspaceId": "AY+MHnorfD2eTxorPE1ebw==",
"healthy": true,
"latencyMs": 88,
"consecutiveFailures": 0,
"lastSuccessAt": "2026-06-30T14:05:00Z",
"probedAt": "2026-06-30T14:05:00Z"
},
"slot": 7
}
],
"nextCursor": "eyJvZmZzZXQiOjUwfQ=="
}{
"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."
}