> ## Documentation Index > Fetch the complete documentation index at: https://docs.proxyscrape.com/llms.txt > Use this file to discover all available pages before exploring further. # Get datacenter 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`. ## OpenAPI ````yaml /openapi-account.json get /v4/account/{subAccountId}/datacenter_shared/proxy-list openapi: 3.0.3 info: title: ProxyScrape Account API description: Account API — authenticate with the api-token header. version: 1.0.0 servers: - url: https://api.proxyscrape.com description: ProxyScrape API security: - apiToken: [] tags: - name: API key management description: Create, list, update, regenerate, and revoke API keys - name: Subaccounts description: List subaccounts and manage preferences - name: Datacenter description: 'Datacenter shared and dedicated: overview, proxy list, usage, whitelist' - name: Residential description: 'Residential (bandwidth): overview, subusers, usage' - name: Residential unlimited description: 'Residential unlimited: overview, statistics, password' - name: SERP API description: 'SERP API: overview, subusers, search' - name: API ordering description: >- Place wallet-paid orders and read the wallet balance via the headless API ordering surface. paths: /v4/account/{subAccountId}/datacenter_shared/proxy-list: get: tags: - Datacenter summary: Get datacenter proxy list description: >- Get the datacenter proxy list for a subaccount. Filter by country, protocol, format, and status. Permission: `datacenter_shared:read` or `datacenter_dedicated:read`. operationId: getDatacenterProxyListV4 parameters: - name: subAccountId in: path required: true schema: type: string format: uuid - name: type in: query description: >- Controls download behaviour. `getproxies` (default) sends a `Content-Disposition: attachment` header so the browser treats the response as a file download, and stamps `last_downloaded` on the account. `displayproxies` returns the same list inline with no download header and no timestamp update. schema: type: string enum: - getproxies - displayproxies - name: country[] in: query description: >- Filter proxies by ISO 3166-1 alpha-2 country code (e.g. `us`, `de`). Pass multiple values to include proxies from any of those countries. Pass `all` (or include `all` in the array) to skip country filtering and return proxies from all countries. schema: type: array items: type: string - name: protocol in: query required: true schema: type: string enum: - http - socks - name: format in: query description: >- Output format. Omit for default plain text (one `host:port` per line). `json` returns a structured object with a data array, totals, and draw counter. `data` returns a country breakdown with counts but no proxy IPs. `credentials` returns credential-formatted lines using the account's proxy username and password — requires `proxy_credentials_enabled` on the account, returns 403 if not enabled. schema: type: string enum: - json - data - credentials - name: proxy_format in: query description: >- Controls how the proxy address is formatted in the output. `ipport` (default) returns bare `host:port`. `protocolipport` prepends the scheme: `http://host:port` or `socks5://host:port`. Has no effect when `format=credentials` — that mode always strips any prefix and derives the scheme from the `protocol` parameter. schema: type: string enum: - ipport - protocolipport default: ipport - name: credential_format in: query description: >- Line format for credential-based output. Only applies when `format=credentials`; silently ignored for all other format values. `1` → `host:port:username:password`. `2` (default) → `username:password@host:port`. `3` → `http://username:password@host:port` or `socks5://username:password@host:port` (scheme derived from the `protocol` parameter). schema: type: integer enum: - 1 - 2 - 3 default: 2 - name: status in: query description: >- Filter proxies by availability. `online` returns only currently reachable proxies. `offline` returns only unreachable proxies. Omit to return all proxies regardless of status. schema: type: string enum: - online - offline - name: start in: query description: Zero-based offset into the filtered result set. Default is `0`. schema: type: integer default: 0 minimum: 0 - name: limit in: query description: >- Maximum number of proxies to return. Can also be passed as `length` (alias). Applied after all other filters. schema: type: integer minimum: 1 - name: length in: query description: Alias for `limit`. schema: type: integer minimum: 1 - name: draw in: query description: >- Arbitrary integer echoed back unchanged in the `draw` field of `format=json` responses. Used by DataTables to correlate requests with responses. Has no effect on other format values. schema: type: integer default: 0 responses: '200': description: >- Success. Response content-type and shape depend on the `format` parameter. content: text/plain: schema: oneOf: - title: Default plain text (format omitted) type: string description: >- One proxy address per line. Format of each line is controlled by `proxy_format`: `ipport` (default) → `host:port`; `protocolipport` → `http://host:port` or `socks5://host:port`. - title: Credential lines (format=credentials) type: string description: >- One credential line per proxy. Line structure is controlled by `credential_format`: `1` → `host:port:username:password`; `2` (default) → `username:password@host:port`; `3` → `http://username:password@host:port` or `socks5://username:password@host:port`. application/json: schema: oneOf: - title: format=json type: object required: - data - recordsTotal - recordsFiltered - draw properties: data: type: array description: >- Each item is a 4-element array: [host:port, protocol, status, countryCode]. items: type: array items: type: string minItems: 4 maxItems: 4 example: - - 1.2.3.4:3129 - HTTP - Online - us recordsTotal: type: integer description: Total proxies before pagination. recordsFiltered: type: integer description: Total proxies after filters, before pagination. draw: type: integer description: Echo of the `draw` request parameter. - title: format=data type: object required: - countries - recordsTotal properties: countries: type: object description: Map of ISO country code to proxy count. additionalProperties: type: integer example: us: 50 de: 30 recordsTotal: type: integer description: Total proxies before pagination. '400': description: >- Bad request. Invalid `type` returns JSON `{status, info}`. Invalid `protocol` or `proxy_format` values return a plain text error string via `die()`. content: text/plain: schema: type: string example: Invalid proxy format. application/json: schema: type: object properties: status: type: string example: bad_request info: type: string example: Invalid request type. '401': description: Unauthorized. The subaccount's subscription has expired. content: application/json: schema: type: object properties: status: type: string example: unauthorized info: type: string example: Your subscription is expired. '403': description: >- Credential-based authentication is not enabled for this account. Returned only when `format=credentials`. content: application/json: schema: type: object properties: error: type: string example: >- Credential-based authentication is not enabled for this account. '404': description: Subaccount not found. content: text/plain: schema: type: string example: Subaccount not found. security: - apiToken: [] components: securitySchemes: apiToken: type: apiKey in: header name: api-token description: >- API key. Create and manage keys at /v4/account/api-keys or in the dashboard. ````