Whitelisted withdrawal addresses

Use these methods to get data about the withdrawal addresses that clients added to their whitelists.

After clients enable the address management option in the B2Core UI, they can make withdrawals only to the addresses that they added to their whitelists.

GET[host]/api/v2/withdrawals/policies

Get a list of whitelisted withdrawal addresses

GET[host]/api/v2/withdrawals/policies/{policyId}

Get whitelisted withdrawal address details

Get a list of whitelisted withdrawal addresses

Use this method to obtain a list of withdrawal addresses added to client whitelists.

Note

If such a request is made by an admin user that is only permitted to view clients with certain tags, a response includes only the withdrawal addresses that are whitelisted by clients marked with these tags.

To obtain detailed information about a specific whitelisted withdrawal address, use a separate method to get whitelisted address details.

Request

Header parameters:

  • Authorization: Bearer <access_token>

Query parameters:

The following filter parameters are available for this method:

clientId

The client identifier.

walletAddress

A string value identifying the address of a wallet that is used for withdrawing funds.

currencyCode

The numeric code of the currency in which a wallet for withdrawing funds is denominated.

isEnabled boolean

If true, the address management option is enabled by a client in the B2Core UI; otherwise, false.

This option allows clients to add withdrawal addresses to their whitelists and withdraw funds only to the whitelisted addresses.

The following sorting parameter is available for this method:

walletAddress

A string value identifying the address of a wallet that is used for withdrawing funds.

Refer to the Query parameters section in the API Overview for details on applying filter and sorting parameters.

GET[host]/api/v2/withdrawals/policies

curl --location -g 'https://host.name/api/v2/withdrawals/policies?limit=10&offset=0&sort_by=walletAddress&filter[clientId]=1&filter[walletAddress]=3J98t1WpEZ73CNmQviecrnyiWrnqRhWNLi&filter[currencyCode]=1000' \
--header 'Authorization: Bearer <token>' \
--header 'accept-language: ja'

Response

A response contains an array of Whitelisted Address objects providing information about the whitelisted addresses matching the request parameters.

Get whitelisted withdrawal address details

Use this method to obtain detailed information about a specified withdrawal address added to a client whitelist.

To obtain a full list of withdrawal addresses added to client whitelists, use a separate method to get whitelisted addresses.

Request

Header parameters:

  • Authorization: Bearer <access_token>

Path parameters:

policyId required

The identifier of a whitelisted withdrawal address.

GET[host]/api/v2/withdrawals/policies/{policyId}

curl --location -g 'https://host.name/api/v2/withdrawals/policies/1' \
--header 'Authorization: Bearer <token>' \
--header 'accept-language: ja'

Response

A response contains a Whitelisted Address object providing information about the specified whitelisted address.