List users in the current account

GET

/users

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://api.proxyrequest.com/api/v1/users?package__id=550e8400-e29b-41d4-a716-446655440002");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Accept-Language: de");
headers = curl_slist_append(headers, "Authorization: Bearer <token>");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

using System.Net.Http.Headers;
var client = new HttpClient();
var request = new HttpRequestMessage
{
    Method = HttpMethod.Get,
    RequestUri = new Uri("https://api.proxyrequest.com/api/v1/users?package__id=550e8400-e29b-41d4-a716-446655440002"),
    Headers =
    {
        { "Accept-Language", "de" },
        { "Authorization", "Bearer <token>" },
    },
};
using (var response = await client.SendAsync(request))
{
    response.EnsureSuccessStatusCode();
    var body = await response.Content.ReadAsStringAsync();
    Console.WriteLine(body);
}

package main

import (
  "fmt"
  "net/http"
  "io"
)

func main() {

  url := "https://api.proxyrequest.com/api/v1/users?package__id=550e8400-e29b-41d4-a716-446655440002"

  req, _ := http.NewRequest("GET", url, nil)

  req.Header.Add("Accept-Language", "de")
  req.Header.Add("Authorization", "Bearer <token>")

  res, _ := http.DefaultClient.Do(req)

  defer res.Body.Close()
  body, _ := io.ReadAll(res.Body)

  fmt.Println(res)
  fmt.Println(string(body))

}

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.proxyrequest.com/api/v1/users?package__id=550e8400-e29b-41d4-a716-446655440002"))
    .header("Accept-Language", "de")
    .header("Authorization", "Bearer <token>")
    .method("GET", HttpRequest.BodyPublishers.noBody())
    .build();
HttpResponse<String> response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://api.proxyrequest.com/api/v1/users?package__id=550e8400-e29b-41d4-a716-446655440002")
  .get()
  .addHeader("Accept-Language", "de")
  .addHeader("Authorization", "Bearer <token>")
  .build();

Response response = client.newCall(request).execute();

import axios from 'axios';

const options = {
  method: 'GET',
  url: 'https://api.proxyrequest.com/api/v1/users',
  params: {package__id: '550e8400-e29b-41d4-a716-446655440002'},
  headers: {'Accept-Language': 'de', Authorization: 'Bearer <token>'}
};

try {
  const { data } = await axios.request(options);
  console.log(data);
} catch (error) {
  console.error(error);
}

const url = 'https://api.proxyrequest.com/api/v1/users?package__id=550e8400-e29b-41d4-a716-446655440002';
const options = {
  method: 'GET',
  headers: {'Accept-Language': 'de', Authorization: 'Bearer <token>'}
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

val client = OkHttpClient()

val request = Request.Builder()
  .url("https://api.proxyrequest.com/api/v1/users?package__id=550e8400-e29b-41d4-a716-446655440002")
  .get()
  .addHeader("Accept-Language", "de")
  .addHeader("Authorization", "Bearer <token>")
  .build()

val response = client.newCall(request).execute()

use reqwest;

#[tokio::main]
pub async fn main() {
    let url = "https://api.proxyrequest.com/api/v1/users";

    let querystring = [
        ("package__id", "550e8400-e29b-41d4-a716-446655440002"),
    ];

    let mut headers = reqwest::header::HeaderMap::new();
    headers.insert("Accept-Language", "de".parse().unwrap());
    headers.insert("Authorization", "Bearer <token>".parse().unwrap());

    let client = reqwest::Client::new();
    let response = client.get(url)
        .query(&querystring)
        .headers(headers)
        .send()
        .await;

    let results = response.unwrap()
        .json::<serde_json::Value>()
        .await
        .unwrap();

    dbg!(results);
}

curl --request GET \
  --url 'https://api.proxyrequest.com/api/v1/users?package__id=550e8400-e29b-41d4-a716-446655440002' \
  --header 'Accept-Language: de' \
  --header 'Authorization: Bearer <token>'

wget --quiet \
  --method GET \
  --header 'Accept-Language: de' \
  --header 'Authorization: Bearer <token>' \
  --output-document \
  - 'https://api.proxyrequest.com/api/v1/users?package__id=550e8400-e29b-41d4-a716-446655440002'

Returns users visible to the caller. Resellers see their sub-users, regular customers see only themselves, and administrators can see all users.

Authorizations

BearerAuth
StaticAuth

Parameters

Query Parameters

email

string

string format: uuid

limit

integer

Number of results to return per page.

offset

integer

The initial index from which to return the results.

ordering

string

Which field to use when ordering the results.

package__id

string format: uuid

Filters the visible user list to accounts that have at least one stored order for this package UUID. Orders are matched regardless of whether they are active or expired; this filter never expands the caller’s normal account scope.

Examples

ResidentialPackage

Residential package

550e8400-e29b-41d4-a716-446655440002

search

string

Case-insensitive partial search across user fields: email, username, first_name, and last_name. Separate multiple terms with spaces or commas; every term must match at least one listed field.

username

string

Header Parameters

Accept-Language

string

default: en

Preferred language for human-readable API errors. Supported languages: en, ru, uk, de, it, fr, es, zh-hans, ja. Regional language tags and quality weights are accepted; unsupported or omitted values use English.

Examples

de

fr-CA, fr;q=0.9, en;q=0.5

Responses

200

The operation completed successfully.

application/json

object

count

required

integer

next

string format: uri

nullable

previous

string format: uri

nullable

results

required

Array<object>

Customer account with contact details, security settings, package data, referral information, and managed sub-users visible to the caller.

object

required

string format: uuid

username

required

Value must contain only letters, numbers, and underscores. It must not start or end with an underscore.

string

<= 150 characters

email

required

string format: email

<= 254 characters

is_reseller

Reseller

Reseller can create sub-users and manage their data.

boolean

is_marketer

Marketer

Marketer can manage marketing campaigns and view analytics.

boolean

is_superuser

Superuser status

Designates that this user has all permissions without explicitly assigning them.

boolean

date_joined

required

string format: date-time

date_joined_ts

required

Timestamp of when the user joined

integer

first_name

string

<= 150 characters

last_name

string

<= 150 characters

balance

integer

<= 2147483647

language

en - EN * de - DE * fr - FR * it - IT * ru - RU

string

Allowed values: en de fr it ru

country

string

<= 255 characters

state

string

<= 255 characters

city

string

<= 255 characters

address

string

<= 255 characters

zip

string

<= 255 characters

company_name

string

<= 255 characters

company_address

string

<= 255 characters

company_city

string

<= 255 characters

company_postal_code

string

<= 255 characters

company_country

string

<= 255 characters

company_vat_number

string

<= 255 characters

allowed_ips

required

List of IP addresses allowed for this user

Array<string>

blocked_domains

required

List of domains blocked for this user

Array<string>

connection_limit

The maximum number of concurrent connections allowed for this package.

integer

>= -1 <= 2147483647

parent_id

required

ID of the parent user (for sub-accounts)

string

sub_users

required

Number of sub-users managed by this reseller

integer

referrals

required

Number of users referred by this user

integer

referral_id

string

<= 255 characters

referral_code

required

string

referral_data_earned

required

integer

referral_data_pending

required

integer

referral_balance_pending

required

integer

referral_balance_earned

required

integer

currency

required

Currency information for the user’s transactions

object

key

additional properties

string

coupons

required

Available coupons for this user

Array<object>

object

key

additional properties

orders

required

The user’s package orders, including inactive orders. Each order contains its own data allowance, usage, ledgers, and proxy credentials. An empty list means the user has no orders.

Array<object>

object

string

<= 36 characters

is_auto_renewal

required

boolean

auto_renewal_percentage

Auto Renewal Threshold (%)

When this percentage of the data allowance has been consumed, the order is automatically renewed if the user has sufficient balance. Set to 0 to disable auto-renewal. 80 → renew when 80% of data is used

integer

<= 70

auto_renewal_data

Auto Renewal Data (GB)

Amount of data in GB to add when auto-renewal is triggered. Set to 0 to use the package default.

integer

<= 10000

package

required

object

key

additional properties

proxy_password

Password used by the customer to authenticate proxy connections. Auto-generated by default — change only if a custom value is needed. Must be between 4 and 64 characters.

string

<= 64 characters

proxy_password_reset

Password Last Changed

Timestamp of the last proxy password change. Read-only — updated automatically whenever the password is rotated.

string format: date-time

nullable

pools

Private proxy pools assigned to this order. Pools restrict which proxy IPs are available to this customer. Leave blank to use the full provider pool.

Array<string>

data

Data Allowance (bytes)

Total data allowance for this order in bytes. 1073741824 = 1 GiB 10737418240 = 10 GiB

integer format: int64

<= 1000000000000000

data_remaining

required

Integer bytes. Root order: sum of usable ledger balances, not data minus data_spent. Virtual child order: max(data - data_spent, 0), a personal quota that does not guarantee the parent still has usable data.

integer

data_spent

Data Spent (bytes)

Total bytes consumed from this order’s data allowance so far. Updated in real time as the customer uses the proxy.

integer format: int64

>= -9223372036854776000 <= 9223372036854776000

ledgers

required

Usable, non-expired ledger balances for a purchased root order; empty for a virtual child order using its parent’s pool. Not a complete history. Array position does not identify the active ledger or spending order.

Array<object>

object

key

additional properties

latest_data_top_up

Latest Top-up (bytes)

Amount of data added to this order in bytes during the most recent top-up.

integer format: int64

>= -9223372036854776000 <= 9223372036854776000

latest_data_top_up_date

Latest Top-up Date

Timestamp of the most recent data top-up, set when an invoice is fulfilled.

string format: date-time

nullable

data_updated

required

Last Used

string format: date-time

updated

required

string format: date-time

created

required

string format: date-time

Examples

example

Example response

{
  "count": 1,
  "next": null,
  "previous": null,
  "results": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440001",
      "username": "developer",
      "email": "[email protected]",
      "is_reseller": true,
      "is_marketer": true,
      "is_superuser": true,
      "date_joined": "2026-07-01T12:30:00Z",
      "date_joined_ts": 1,
      "first_name": "Dana",
      "last_name": "Morgan",
      "balance": 1,
      "language": "en",
      "country": "us",
      "state": "state",
      "city": "los_angeles",
      "address": "address",
      "zip": "zip",
      "company_name": "company name",
      "company_address": "company address",
      "company_city": "company city",
      "company_postal_code": "company postal code",
      "company_country": "company country",
      "company_vat_number": "company vat number",
      "allowed_ips": [
        "198.51.100.25"
      ],
      "blocked_domains": [
        "blocked.example"
      ],
      "connection_limit": 1,
      "parent_id": "550e8400-e29b-41d4-a716-446655440001",
      "sub_users": 1,
      "referrals": 1,
      "referral_id": "550e8400-e29b-41d4-a716-446655440001",
      "referral_code": "referral code",
      "referral_data_earned": 1,
      "referral_data_pending": 1,
      "referral_balance_pending": 1,
      "referral_balance_earned": 1,
      "currency": "USD",
      "coupons": [
        {}
      ],
      "orders": [
        {
          "id": "550e8400-e29b-41d4-a716-446655440001",
          "is_auto_renewal": true,
          "auto_renewal_percentage": 1,
          "auto_renewal_data": 1,
          "package": {},
          "proxy_password": "p9W4rT2xK7mQ",
          "proxy_password_reset": "2026-07-01T12:30:00Z",
          "pools": [
            "residential"
          ],
          "data": 1073741824,
          "data_remaining": 1,
          "data_spent": 1073741824,
          "ledgers": [
            {}
          ],
          "latest_data_top_up": 1,
          "latest_data_top_up_date": "2026-07-01T12:30:00Z",
          "data_updated": "2026-07-01T12:30:00Z",
          "updated": "2026-07-01T12:30:00Z",
          "created": "2026-07-01T12:30:00Z"
        }
      ]
    }
  ]
}

400

The request is malformed or violates a business rule.

application/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>

key

additional properties

One of:

string
Array<string>

string

Examples

ValidationError

Validation error

{
  "non_field_errors": [
    "The request could not be processed."
  ]
}

Headers

Content-Language

string

Language used for human-readable errors.

401

Authentication credentials are missing, expired, or invalid.

application/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>

key

additional properties

One of:

string
Array<string>

string

Examples

AuthenticationRequired

Authentication required

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

Headers

Content-Language

string

Language used for human-readable errors.

403

The authenticated account cannot perform this operation.

application/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>

key

additional properties

One of:

string
Array<string>

string

Examples

PermissionDenied

Permission denied

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

Headers

Content-Language

string

Language used for human-readable errors.