Search...
APIJSLog inGet started in sandbox
Airwallex logo
Home
Platform APIs
Connected Accounts
Accounts
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 schemasRetrieve supported beneficiary banksVerify a beneficiary account
Embedded Beneficiary component

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.

Was this page helpful?