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

# Listar Grupos de Whitelist

> GET /v2/naas/wl_groups — lista os grupos de carteiras externas Fireblocks do sub-merchant.

## Response `200 OK`

| Campo                           | Tipo   | Descrição                                             |
| ------------------------------- | ------ | ----------------------------------------------------- |
| `groups`                        | array  | Grupos de carteira registrados para este sub-merchant |
| `groups[].id`                   | string | ID do grupo de carteira Fireblocks                    |
| `groups[].label`                | string | Nome legível do grupo                                 |
| `groups[].addresses`            | array  | Endereços registrados neste grupo                     |
| `groups[].addresses[].id`       | string | ID da entrada de endereço                             |
| `groups[].addresses[].address`  | string | Endereço cripto                                       |
| `groups[].addresses[].currency` | string | Código do ativo                                       |
| `groups[].addresses[].status`   | string | `active` ou `pending`                                 |

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET https://checkout.noxpay.io/v2/naas/wl_groups \
    -H "api-key: <key>" \
    -H "X-Timestamp: 2026-05-27T14:30:00Z" \
    -H "X-Correlation-ID: a1b2c3d4-e5f6-4789-abcd-000000000001" \
    -H "X-Signature: <assinatura-dos-headers>"
  ```

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

  # Headers assinados
  headers = sign_get_headers(private_key, "a1b2c3d4-e5f6-4789-abcd-000000000001")
  headers["api-key"] = "<key>"
  response = requests.get(
      "https://checkout.noxpay.io/v2/naas/wl_groups",
      headers=headers,
  )
  print(response.json())
  ```

  ```javascript Node.js theme={null}
  // Headers assinados
  const headers = signGETHeaders("a1b2c3d4-e5f6-4789-abcd-000000000001");
  headers["api-key"] = "<key>";
  const response = await fetch("https://checkout.noxpay.io/v2/naas/wl_groups", {
    method: "GET",
    headers,
  });
  const data = await response.json();
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "groups": [
      {
        "id": "fb-wallet-abc123",
        "label": "Tesouraria",
        "addresses": [
          {
            "id": "addr-1",
            "address": "0xABC123...",
            "currency": "USDT_ETH",
            "status": "active"
          }
        ]
      }
    ]
  }
  ```
</ResponseExample>