Search...
Log inGet started
Airwallex logo
Home
Core API
Payments
Transactional FX
Payouts
Issuing
Back to home
OverviewHow Airwallex Payouts work
Payout network
Use cases
Beneficiaries
Create beneficiariesValidate a beneficiaryRetrieve beneficiaries
Manage beneficiariesUsing API and form schemas Embedded Beneficiary component
Test and go live
Older API versions

Retrieve beneficiaries

Retrieve a list of beneficiaries

Call Get list of beneficiaries API to retrieve saved beneficiary information. You can specify the time period when the beneficiary was created (from_date, to_date) and the pagination parameters (page_num, page_size) to refine the results. You can also use other filters such as bank_account_number, company_name, entity_type, and nick_name. The response will return a list of beneficiaries, each in the same manner as in the response body of Create a beneficiary API.

Example request

Shell

If you are registered as a platform account, you can call this endpoint on behalf of your connected accounts by specifying the open ID in the x-on-behalf-of header.

Example response

JSON

Retrieve details of a beneficiary

Call Get a beneficiary by ID API to retrieve details of a specific saved beneficiary, by specifying the beneficiary_id in the endpoint URL. A successful request will return the beneficiary details in the same manner as in the response body of Create a new beneficiary API.

Example request

Shell

If you are registered as a platform account, you can call this endpoint on behalf of your connected accounts by specifying the open ID in the x-on-behalf-of header.