> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gmproxys.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Listar Proxies

> Retorna todos os usuário da proxy da conta.

Retorna todos os usuário da proxy associadas à sua API Key.

## Headers

<ParamField header="X-API-Key" type="string" required>
  Sua chave de API no formato `gm_SUA_CHAVE`.
</ParamField>

## Resposta

<ResponseField name="subusers" type="array">
  Lista de usuário das proxies da conta. Cada item contém os mesmos campos retornados em [Criar Proxy](/api-reference/proxy/create-proxy).
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET https://api.gmproxys.com/v1/list \
    -H "X-API-Key: gm_SUA_CHAVE"
  ```

  ```javascript Node.js theme={null}
  const response = await fetch("https://api.gmproxys.com/v1/list", {
    method: "GET",
    headers: {
      "X-API-Key": "gm_SUA_CHAVE",
    },
  });

  const data = await response.json();
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      "https://api.gmproxys.com/v1/list",
      headers={"X-API-Key": "gm_SUA_CHAVE"},
  )

  print(response.json())
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "subusers": [
      {
        "id": 1001,
        "login": "82364cb158467f5e5a64",
        "password": "ba4d43e7b0ee471c",
        "balance": 0,
        "balance_format": 0,
        "threads": 2000,
        "allowed_ips": [],
        "blocked": false,
        "type": "residential",
        "default_pool_parameters": {
          "countries": ["us"],
          "cities": ["california", "alabama"],
          "states": [],
          "exclude_countries": []
        },
        "blocked_hosts": []
      },
      {
        "id": 1002,
        "login": "07146743e93162ff4ac5",
        "password": "95511815bcfd25b2",
        "balance": 0,
        "balance_format": 0,
        "threads": 2000,
        "allowed_ips": [],
        "blocked": false,
        "type": "residential",
        "default_pool_parameters": {
          "countries": ["br"],
          "cities": ["saopaulo", "parana"],
          "states": [],
          "exclude_countries": []
        },
        "blocked_hosts": []
      }
    ]
  }
  ```

  ```json 401 Token inválido theme={null}
  {
    "success": false,
    "message": "Invalid API token."
  }
  ```
</ResponseExample>