v1
latestOpenAPI 3.1.0Proprietary2026-07-2464170247.4 KBOnboarding V2
List Business Accounts
List business accounts under a Main-Account.
get/v2/accounts/{main_account_id}/businesses
Path parameters
main_account_idstring required
Main account id in the form BZ-XXXX-XXXX.
Query parameters
pageinteger
Page number (starts from 1, default: 1)
sizeinteger
Number of items per page (1-100, default: 10)
external_idstring
main_onlyboolean
When true, return only the MAIN account's direct sub-accounts (excludes deeper levels; preserves the previous list behaviour).
parent_account_idstring
Return only sub-accounts whose direct parent is this account id.
Response
Businesses listed successfully.
Example response
{
"accounts": [
{
"external_id": "ext-1234",
"registration": {
"incorporated_at": "2020-01-15",
"address": {
"street_line_1": "123 Main Street",
"city": "San Francisco",
"state": "CA",
"postal_code": "94102"
},
"tax_id": "12-3456789"
},
"operating_address": {
"street_line_1": "123 Main Street",
"city": "San Francisco",
"state": "CA",
"postal_code": "94102"
},
"controllers": [
{
"residential_address": {
"street_line_1": "123 Main Street",
"city": "San Francisco",
"state": "CA",
"postal_code": "94102"
},
"tax_info": {
"number": "12-3456789"
},
"identification": {
"id_number": "A12345678"
}
}
],
"terms": [
{
"url": "https://www.1money.com/legal-and-privacy/privacy-policy",
"name": "Privacy Policy"
}
],
"errors": [
{
"type": "FIELD_VALIDATION",
"description": "Invalid value for field 'industry'.",
"target": {
"scope": "BUSINESS",
"data": {
"controller_id": "8d3e45fa-b76c-45e2-abd1-aa9d29d20964",
"intermediary_id": "0c8b9d1e-3f4a-4b2c-9d8e-1a2b3c4d5e6f",
"property": "industry",
"document_type": "CERT_OF_INC"
}
}
}
]
}
]
}