Skip to content

List active proxy sessions

GET
/sessions
curl --request GET \
--url https://api.proxyrequest.com/api/v1/sessions \
--header 'Authorization: Bearer <token>'

Returns sticky proxy session identifiers owned by the authenticated username. At most the configured safety limit is returned.

The operation completed successfully.

Media typeapplication/json
Array<object>
object
count
required
integer
results
required
Array<string>
Examples
ExampleActiveSessions

Active sessions

[
{
"count": 2,
"results": [
"session:developer:residential-us:7f6c1d",
"session:developer:residential-us:08b3a2"
]
}
]

The request is malformed or violates a business rule.

Media typeapplication/json

Validation and API error payload. Field names may be added dynamically; field errors are returned as arrays of human-readable messages.

object
detail
string
non_field_errors
Array<string>
translation

Stable translation key suitable for client localisation.

string
key
additional properties
One of:
string
Examples
ExampleValidationError

Validation error

{
"non_field_errors": [
"The request could not be processed."
],
"translation": "errors.request.invalid"
}

Authentication credentials are missing, expired, or invalid.

Media typeapplication/json

Validation and API error payload. Field names may be added dynamically; field errors are returned as arrays of human-readable messages.

object
detail
string
non_field_errors
Array<string>
translation

Stable translation key suitable for client localisation.

string
key
additional properties
One of:
string
Examples
ExampleAuthenticationRequired

Authentication required

{
"detail": "Authentication credentials were not provided."
}

The authenticated account cannot perform this operation.

Media typeapplication/json

Validation and API error payload. Field names may be added dynamically; field errors are returned as arrays of human-readable messages.

object
detail
string
non_field_errors
Array<string>
translation

Stable translation key suitable for client localisation.

string
key
additional properties
One of:
string
Examples
ExamplePermissionDenied

Permission denied

{
"detail": "You do not have permission to perform this action."
}