---
title: "Get proxy by ID"
method: GET
path: "/connect/proxies/{id}"
tags: ["Proxies"]
---

# Get proxy by ID

`GET /connect/proxies/{id}`

Returns the proxy identified by the path ID. The response includes the proxy's password.

## Response `200`

The proxy, including its password.

- ProxyWithSecret — A proxy including its password. Returned only on create and single-proxy reads.
  - `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
  - `password` string, required
  - `paymentUrl` string, nullable — Checkout URL to complete payment while status is `pending_payment`. Null once paid or when no payment was required.

## Other responses

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

---

[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)