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

# Get proxy by ID

`GET /proxies/{id}`

Retrieve a proxy in the resolved project by ID.

## Path parameters

- `id` string, required

## Response `200`

Proxy retrieved

- Proxy — Configuration for routing traffic through a proxy.
  - `id` string
  - `name` string — Readable name of the proxy.
  - `type` 'datacenter' | 'isp' | 'residential' | 'mobile' | 'custom', required — Proxy type to use. In terms of quality for avoiding bot-detection, from best to worst: `mobile` > `residential` > `isp` > `datacenter`.
  - `protocol` 'http' | 'https' — Protocol to use for the proxy connection.
  - `bypass_hosts` string[] — Hostnames that should bypass the parent proxy and connect directly.
  - `status` 'available' | 'unavailable' — Current health status of the proxy.
  - `last_checked` string, date-time — Timestamp of the last health check performed on this proxy.
  - `ip_address` string — IP address that the proxy uses when making requests.
  - `config` union — Configuration specific to the selected proxy `type`.
    - DatacenterProxyConfig — Configuration for a datacenter proxy.
      - `country` string — ISO 3166 country code. Defaults to US if not provided.
    - IspProxyConfig — Configuration for an ISP proxy.
      - `country` string — ISO 3166 country code. Defaults to US if not provided.
    - ResidentialProxyConfig — Configuration for residential proxies.
      - `country` string — ISO 3166 country code.
      - `city` string — City name (no spaces, e.g. `sanfrancisco`). If provided, `country` must also be provided.
      - `state` string — Two-letter state code.
      - `zip` string — US ZIP code.
      - `asn` string — Autonomous system number. See https://bgp.potaroo.net/cidr/autnums.html
      - `os` 'windows' | 'macos' | 'android' — Operating system of the residential device.
    - MobileProxyConfig — Configuration for mobile proxies.
      - `country` string — ISO 3166 country code
      - `city` string — Provider city alias. Mobile carrier routing can make observed geo vary.
      - `state` string — US-only state code. Mobile carrier routing can make observed geo vary.
    - CustomProxyConfig — Configuration for a custom proxy (e.g., private proxy server).
      - `host` string, required — Proxy host address or IP.
      - `port` integer, required — Proxy port.
      - `username` string — Username for proxy authentication.
      - `has_password` boolean — Whether the proxy has a password.
      - `has_ca_bundle` boolean — Whether the proxy has a custom CA bundle configured.

## Other responses

- `401` — Unauthorized – missing or invalid authorization token
- `403` — Forbidden – insufficient permissions or plan
- `404` — Resource not found
- `500` — Internal Server Error

---

[API](https://skmtc.net/kernel/apis/kernel-api.md) · [All operations](https://skmtc.net/kernel/apis/kernel-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kernel/kernel-api/versions/9e8ce9fcf5e1/schema)