Getting a list of whitelist

Getting details of all your whitelists

🔗

To get a list of your whitelists, use the endpoint GET /whitelist to retrieve information and details on all your whitelists. To do this the user must have viewer as their API key role.

Query Parameters

Users can filter their request by using the following parameters :

ComponentTypeDescription
limitnumberDefault at 200
offsetnumberOffset for pagination
whitelist_typestringType of whitelist to filter by
asset_idstringAsset ID to retrieve in whitelist
network_idstringNetwork ID to retrieve in whitelist

Enumerated values are the predefined values that the variable can take. For example, "whitelist_type" value can either be "my_organization" or "third_party"

ParameterPossible Values
whitelist_typemy_organization, third_party

Response

The list of whitelist will contain and array of whitelists as a JSON object with the following details :

ComponentTypeDescription
whitelistsstringWhitelists
whitelist_idstringID of the whitelist
whitelist_namestringName of the whitelist
whitelist_typestringType of the whitelist

The detail of the "assets" will include the following components:

ComponentTypeDescription
asset_idstringID of the asset
asset_namestringName of the asset
network_idstringID of the network
network_namestringName of the network
addressstringWallet address
memostringMemo for address of asset types with memo, tag or note

Example Response

{
        "timestamp": "2019-03-04T12:58:12.000Z",
        "whitelists": [
            {
                "whitelist_id": "788",
                "whitelist_name": "Nanthapass",
                "whitelist_type": "Third party",
                "assets":[ 
                    {
                        "asset_id": "ETH",
                        "asset_name": "Ethereum",
                        "network_id" : "ETH",
                        "network_name": "Ethereum",
                        "address": "0wnf9ac",
                        "memo": ""
                    },
                    {
                        "asset_id": "BTC",
                        "asset_name": "Bitcoin",
                        "network_id": "BTC",
                        "network_name": "Bitcoin",
                        "address": "3FZbgi29cpjq2Gj..",
                        "memo": ""
                    }
                ]
            },
            {
                "whitelist_id": "1367",
                "whitelist_name": "Greener",
                "whitelist_type": "My organization's",
                "assets":
                    {
                        "asset_id": "XRP",
                        "asset_name": "Ripple",
                        "network_id": "XRP",
                        "network_name": "Ripple",
                        "address": "rBjXGvdHt1...",
                        "memo": "4058079792"
                }
            }
        ], 
		}