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

# List Whitelist Addresses

> Get the addresses on your whitelists, with their approval status.

**[MCP scope](https://apidocs.finrock.io/api-reference/mcp-scopes.md):** `dac.read`

Use this endpoint to list whitelist addresses, including ones still waiting for approval. To list only the active addresses, use [List Active Whitelisted Addresses](https://apidocs.finrock.io/api-reference/whitelists/list-active-whitelisted-addresses.md).

## Query Parameters

**guid** `string`

The ID of a whitelist, from [List Whitelists](https://apidocs.finrock.io/api-reference/whitelists/list-whitelists.md). Only return addresses on this whitelist.

```bash cURL theme={null}
curl --request GET \
     --url 'https://api.finrock.io/dac/v1/whitelist-address?guid=8fb22996-2cd1-4a2a-9773-ebfde21c6982' \
     --header 'Authorization: Bearer {JWT}' \
     --header 'accept: application/json' \
     --header 'x-api-key: YOUR_API_KEY'
```

## Response

An array of addresses.

**id** `integer`

The ID of the address entry. Use it to remove the address with [Remove Whitelist Address](https://apidocs.finrock.io/api-reference/whitelists/remove-whitelist-address.md).

**asset** `string`

The asset the address is for. Empty if the address applies to all assets.

**address** `string`

The wallet address.

**tag** `string`

The destination tag or memo, if any.

**label** `string`

The label given to the address.

**added\_on** `string`

When the address was added, in UTC.

**status** `string`

Whether the address can be used.

* `UnApproved`: waiting for approval.
* `Active`: approved and usable.

Rejected and removed addresses aren't returned.

**approvals** `array`

The approvals the address needs.

**properties**

**UserName** `string`

The person who needs to approve, or who approved. The keys in `approvals` entries are capitalised (`UserName`, `UserRole`), while `action` and `action_date` are lower-case.

**UserRole** `string`

Their role, for example `Owner`.

**action** `string`

What they did: `Approved` or `Rejected`. Empty (`""`) while their approval is still pending.

**action\_date** `string`

When they acted. Empty (`""`) while their approval is still pending.

```json 200 theme={null}
[
  {
    "id": 56,
    "asset": "ETH",
    "address": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
    "tag": "",
    "label": "ETH Address 1",
    "added_on": "2026-11-02T12:04:28Z",
    "approvals": [
      {
        "UserName": "Jane Doe",
        "UserRole": "Owner",
        "action": "",
        "action_date": ""
      }
    ],
    "status": "UnApproved"
  }
]
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.