---
title: "List proxies"
method: GET
path: "/connect/proxies"
tags: ["Proxies"]
---

# List proxies

`GET /connect/proxies`

Returns proxies owned by the calling tenant (the X-Owner-Id header, falling back to X-User-ID). Credentials are omitted from the list.

## Query parameters

- `page` integer
- `pageSize` integer
- `country` string, country-code

## Response `200`

The caller's proxies, without credentials.

- ProxyList — A page of proxies.
  - `items` Proxy[], required
    - `country` string, required — ISO 3166-1 alpha-2 country code (lowercase).
    - `createdAt` string, date-time, required
    - `host` string, required
    - `id` string, uuid, required
    - `port` integer, required
    - `status` 'pending_payment' | 'provisioning' | 'active' | 'cancelling' | 'ended' | 'error', required — Lifecycle of a proxy. A freshly created proxy is `provisioning` — or `pending_payment` until the customer completes checkout — and becomes `active` once its upstream is assigned. `cancelling` retains full access through the paid period; when the subscription expires the proxy is `ended`. `error` marks a failed provisioning attempt.
    - `type` 'dedicated_residential' | 'residential' | 'mobile', required
    - `username` string, required
  - `pagination` PaginationMeta1, required — Pagination metadata for a list response.
    - `hasNext` boolean, required — Whether a next page exists.
    - `hasPrev` boolean, required — Whether a previous page exists.
    - `page` integer, required — Current page number (1-based).
    - `pageSize` integer, required — Number of items per page.
    - `pages` integer, required — Total number of pages.
    - `total` integer, required — Total number of items across all pages.

## Other responses

- `401` — The X-User-ID header was missing or invalid, or a present X-Owner-Id header was not a uuid.

## Changes

- **2026-07-10** `ae1fe0ca6359` — 1 info
  - the `type` response's property default value `dedicated_residential` was removed for the status `200`
- **2026-07-08** `6d835ec1e768` — 1 info
  - the endpoint scheme security `OwnerIDHeader AND UserIDHeader` was added to the API
- **2026-07-01** `1229ad911e2e` — 3 info
  - api tag `Proxies` added
  - api tag `proxies` removed
  - the `type` response's property default value changed from `residential` to `dedicated_residential` for the status `200`
- **2026-06-29** `3cb3612f45e0` — 2 warning
  - added the new `dedicated_residential` enum value to the `items/items/type` response property for the response status `200`
  - added the new `mobile` enum value to the `items/items/type` response property for the response status `200`
- **2026-06-05** `49b7fa16d8f6` — 1 info
  - endpoint added

[Full history](https://skmtc.dev/droidrun/apis/droidrun-cloud/changes/connect/proxies/get.md)

---

[API](https://skmtc.dev/droidrun/apis/droidrun-cloud.md) · [All operations](https://skmtc.dev/droidrun/apis/droidrun-cloud/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/droidrun/droidrun-cloud/revisions/02da4f9ce3fd/schema)