Onboard multiple connected accounts for the same legal entity

As a platform, you have the ability to create multiple accounts for one existing, KYC-verified account. These supplementary accounts, which are tied to the same legal entity as the initial account, will all function as separate connected accounts to the platform. Notably, supplementary accounts for the same legal entity bypass the need for KYC verification and receive immediate approval.

Each account is equipped with its own wallet. Using multiple accounts for the same legal entity can be used to facilitate reconciliation as it enables each account to manage its segregated funds for various purposes — like inbound money transfers and treasury management — separately.

Step 1: Retrieve the legal entity

Call List all accounts API to retrieve the list of connected accounts associated with your platform account.

Example request

Shell
1curl --request GET 
2--url 'https://api-demo.airwallex.com/api/v1/accounts?account_status=string&email=string&from_created_at=2017-04-01&identifier=string&metadata=string&page_num=0&page_size=100&to_created_at=2017-04-01' 
3--header 'Authorization: Bearer <your_bearer_token>' 
4

Example response

JSON
1{
2    "has_more": false,
3    "items": [
4         {
5            "account_details": {...},
6                "business_details": {...},
7                "trustee_details": null,
8                "individual_details": null,
9                "legal_entity_id": "le_lSZ5eOunOT-Nvj54Oe7H2A",
10                "legal_entity_type": "BUSINESS",
11                "authorised_person_details": {...},
12                "legal_rep_details": {...},
13                "controlling_person_details": {...},
14                "beneficial_owners": [],
15                "director_details": []
16            },
17            "account_usage": {...},
18            "created_at": "2023-02-02T13:04:26+0000",
19            "customer_agreements": {...},
20            "id": "acct_o-etPE29MlaqjzhF4UTIRQ",
21            "nickname": "Deal Fund",
22            "primary_contact": {...},
23            "status": "ACTIVE",
24            "view_type": "EXCLUDED_PII"
25        },
26.....
27.....
28.....

Step 2: Create a new connected account under the same legal entity

Use the returned legal_entity_id of a connected account to create a new connected account under the same legal entity ID. By reusing the same legal entity and providing a different identifier, the account transitions to ACTIVE status without passing KYC.

Example request

Shell
1curl --request POST
2--url 'https://api-demo.airwallex.com/api/v1/accounts/create' 
3--header 'Content-Type: application/json' 
4--header 'Authorization: Bearer <your_bearer_token>'
5--data '{
6"account_details": {
7        "legal_entity_id": "le_lSZ5eOunOT-Nvj54Oe7H2A"
8    },
9    "identifier": "Multiple accounts by API",
10    "primary_contact": {
11    }
12}

Example response

JSON
1{
2    "account_details": {...},
3        "business_details": {...},
4        "trustee_details": null,
5        "individual_details": null,
6        "legal_entity_id": "le_lSZ5eOunOT-Nvj54Oe7H2A",
7        "legal_entity_type": "BUSINESS",
8        "authorised_person_details": {...},
9        "legal_rep_details": {...},
10        "controlling_person_details": {...},
11        "beneficial_owners": [...],
12        "director_details": []
13    },
14    "account_usage": {..},
15    "created_at": "2023-06-05T14:50:02+0000",
16    "customer_agreements": {...},
17    "id": "acct_5ADNyETZMgK1SbBtDB28bw",
18    "identifier": "MASE by API",
19    "nickname": "OurCrowd Deals UI",
20    "primary_contact": {...},
21    "status": "ACTIVE",
22    "view_type": "COMPLETE"
23}

Step 3: Retrieve connected account details

You can retrieve details of the new connected account anytime using Retrieve a connected account API.