Box’a’Fox
API referenceProxy users

List proxy users

GET
/v1/proxy-users

Passwords are included. Sort: username, created_at, residential_bytes_used, mobile_bytes_used. Filters: status, username, like_username, is_default, min_/max_*_bytes_used, metadata., include_deleted.

Authorization

ApiKey
headerX-API-Key<token>

prx_live_<40 base62>

Query Parameters

page?integer
Formatint64
Range1 <= value
Default1
per_page?integer
Formatint64
Range1 <= value <= 100
Default25
sort_by?string

username | created_at | residential_bytes_used | mobile_bytes_used, optionally with _desc. Default created_at_desc.

status?string
Value in"active""disabled"
username?string
like_username?string

Case-insensitive contains, % wildcard.

is_default?boolean
min_residential_bytes_used?integer
Formatint64
max_residential_bytes_used?integer
Formatint64
min_mobile_bytes_used?integer
Formatint64
max_mobile_bytes_used?integer
Formatint64
include_deleted?boolean

Response Body

OK

application/json
  1. response
data*array<>|null
message*string
page*integer

Current page (1-based).

Formatint64
per_page*integer

Items per page (1–100).

Formatint64
total_count*integer

Exact total across all pages.

Formatint64
curl -X GET "https://example.com/v1/proxy-users"
{  "data": [    {      "created_at": "2019-08-24T14:15:22Z",      "deleted_at": "2019-08-24T14:15:22Z",      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "is_default": true,      "metadata": {        "property1": null,        "property2": null      },      "mobile_bytes_limit": 0,      "mobile_bytes_used": 0,      "password": "string",      "residential_bytes_limit": 0,      "residential_bytes_used": 0,      "status": "active",      "updated_at": "2019-08-24T14:15:22Z",      "username": "string",      "whitelist_ips": [        "string"      ]    }  ],  "message": "OK",  "page": 1,  "per_page": 25,  "total_count": 137}