---
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.

---

[API](https://skmtc.net/mobilerun/apis/workflows.md) · [All operations](https://skmtc.net/mobilerun/apis/workflows/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mobilerun/workflows/revisions/1bc499aa8f99/schema)