---
title: "Retrieve Proxy"
method: GET
path: "/public/user/proxy/retrieve/{proxy_id}"
tags: ["Proxy"]
---

# Retrieve Proxy

`GET /public/user/proxy/retrieve/{proxy_id}`

Retrieves a specific Proxy based on the provided ID for the current user's account, ensuring
that only proxies associated with the customer services and in use are returned.

## Path parameters

- `proxy_id` string, required

## Response `200`

Successful Proxy Retrieve

- object — Proxy retrieve was successful.
  - `data` object — Retrieved Proxy item details.
    - `asn_id` integer
    - `asn_name` string
    - `city_example_postcode` string
    - `city_id` integer
    - `city_latitude` number
    - `city_longitude` number
    - `city_name` string
    - `city_timezone` string
    - `country_id` string
    - `country_name` string
    - `customer_id` integer
    - `default_proxy_user_password` string
    - `default_proxy_user_username` string
    - `ip_address_id_v4` string
    - `ip_address_id_v6` string
    - `proxy_http_port` integer
    - `proxy_id` string
    - `proxy_ip_address` string
    - `proxy_ip_address_v6` string
    - `proxy_last_update_datetime` string, date-time
    - `proxy_password` string
    - `proxy_protocol` 'ipv4' | 'ipv6' | 'dual'
    - `proxy_socks5_port` integer
    - `proxy_status` 'available' | 'in_use' | 'reserved' | 'waiting' | 'pending_deletion'
    - `proxy_type` 'datacenter' | 'isp' | 'residential' | 'mobile'
    - `proxy_user_ids` string[]
    - `proxy_username` string
    - `service_id` string
    - `subdivision_id` string
    - `subdivision_name` string
    - `subnet_id` string
    - `subnet_id_v6` string
    - `http_formatted` string
    - `socks5_formatted` string
  - `message` string — Status message for the retrieval.

---

[API](https://skmtc.dev/byteful/apis/byteful-public-user-api.md) · [All operations](https://skmtc.dev/byteful/apis/byteful-public-user-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/byteful/byteful-public-user-api/revisions/3db1a6fc0099/schema)