---
title: "Get datacenter proxy list"
method: GET
path: "/v4/account/{subAccountId}/datacenter_shared/proxy-list"
tags: ["Datacenter"]
---

# Get datacenter proxy list

`GET /v4/account/{subAccountId}/datacenter_shared/proxy-list`

Get the datacenter proxy list for a subaccount. Filter by country, protocol, format, and status. Permission: `datacenter_shared:read` or `datacenter_dedicated:read`.

## Path parameters

- `subAccountId` string, uuid, required

## Query parameters

- `type` 'getproxies' | 'displayproxies'
- `country[]` string[]
- `protocol` 'http' | 'socks', required
- `format` 'json' | 'data' | 'credentials'
- `proxy_format` 'ipport' | 'protocolipport'
- `credential_format` 1 | 2 | 3
- `status` 'online' | 'offline'
- `start` integer
- `limit` integer
- `length` integer
- `draw` integer

## Response `200`

Success. Response content-type and shape depend on the `format` parameter.

- union
  - object
    - `data` array[], required — Each item is a 4-element array: [host:port, protocol, status, countryCode].
      - string[]
    - `recordsTotal` integer, required — Total proxies before pagination.
    - `recordsFiltered` integer, required — Total proxies after filters, before pagination.
    - `draw` integer, required — Echo of the `draw` request parameter.
  - object
    - `countries` object, required — Map of ISO country code to proxy count.
    - `recordsTotal` integer, required — Total proxies before pagination.

## Other responses

- `400` — Bad request. Invalid `type` returns JSON `{status, info}`. Invalid `protocol` or `proxy_format` values return a plain text error string via `die()`.
- `401` — Unauthorized. The subaccount's subscription has expired.
- `403` — Credential-based authentication is not enabled for this account. Returned only when `format=credentials`.
- `404` — Subaccount not found.

---

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