crate::account::agreement::controller::openapi_v2::signatures1

crate::account::identity::controller::openapi::business::accounts9

crate::account::identity::controller::openapi::individual::accounts1

crate::connectivity::controller::openapi::deposit_instructions5

crate::connectivity::controller::openapi::withdrawals3

crate::connectivity::fiat::controller::openapi::external_accounts5

crate::connectivity::fiat::controller::openapi::fiat_deposit_accounts1

crate::connectivity::fiat::controller::openapi::virtual_accounts7

crate::trading::controller::openapi::conversions3

crate::transaction::compliance::rfi::controller::openapi4

crate::transaction::compliance::rfi::controller::preflight1

crate::transaction::history::controller::openapi::transactions2

crate::transaction::instruction::controller::openapi::auto_conversion_rule7

crate::transaction::ledger::controller::openapi::assets1

crate::transaction::ledger::controller::openapi::transfers3

crate::transaction::pricing::controller::openapi::fees1

crate::transaction::pricing::controller::openapi::partner_fee_routes5

crate::web::openapi::recipients12

crate::web::openapi::simulations1

Webhook recovery6

crate::account::identity::controller::openapi::business::accounts

GET /v2/accounts/{main_account_id}/businesses

Changed on Nov 3, 2026

Request

Base URL
https://api.1money.com
Auth
HTTP bearer
TypeScript
https://skmtc.dev/1money/apis/1money-openapi/docs/v2/accounts/:main_account_id/businesses/get.ts
A function with typed inputs. Its response is checked against the schema.

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

parent_account_idstring

Return only sub-accounts whose direct parent is this account id.

main_onlyboolean

When true, return only the MAIN account's direct sub-accounts (excludes deeper levels; preserves v1 list behaviour).

Response

Businesses listed successfully.

totalinteger required

Total number of business sub-accounts matching the query, across all pages.

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"
          }
        }
      ],
      "intermediaries": [
        {
          "id": "IT-ABCD-1234"
        }
      ],
      "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"
            }
          }
        }
      ],
      "deleted_at": "2026-08-31T12:30:00Z"
    }
  ]
}

Changes

Nov 3, 2026d213edbaccb6 Revision changes
- breaking
  the response property /////// became optional for the status
- breaking
  added to the // response property oneOf list for the response status
- breaking
  added subschema #1 to the /////// response property oneOf list for the response status
- breaking
  the // response's property type changed from no type to string for status
- breaking
  the // response's property type changed from no type to string for status
- breaking
  the /////// response's property type changed from string to no type for status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- warning
  removed the optional property // from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  added the new ADVERTISING_MARKETING_PR enum value to the ////// response property for the response status
- warning
  added the new ART_ANTIQUITIES_DEALERS enum value to the ////// response property for the response status
- warning
  added the new BQ enum value to the //////// response property for the response status
- warning
  added the new BQ enum value to the ///////// response property for the response status
- warning
  added the new BQ enum value to the //////// response property for the response status
- warning
  added the new BQ enum value to the ///////// response property for the response status
- warning
  added the new BQ enum value to the ///////// response property for the response status
- warning
  added the new BQ enum value to the //// response property for the response status
- warning
  added the new BQ enum value to the //////// response property for the response status
- warning
  added the new CHARITIES_NON_PROFIT enum value to the ////// response property for the response status
- warning
  added the new COMMODITY_TRADING enum value to the ////// response property for the response status
- warning
  added the new COMPANY_FORMATION_TCSP enum value to the ////// response property for the response status
- warning
  added the new FREIGHT_FORWARDING enum value to the ////// response property for the response status
- warning
  added the new IMPORT_EXPORT_TRADE_FINANCE enum value to the ////// response property for the response status
- warning
  added the new PAYROLL_PEO_EOR enum value to the ////// response property for the response status
- warning
  added the new RESIDENCE_PERMIT enum value to the ///////// response property for the response status
- info
  api tag crate::account::identity::controller::openapi::business::accounts added
- info
  api tag Onboarding V2 removed
- info
  added the optional property ////// to the response with the status
- info
  added the optional property // to the response with the status
- info
  added the optional property //// to the response with the status
- info
  added the optional property //// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property // to the response with the status
- info
  the response property // became required for the status
- info
  the response property // became required for the status
- info
  the response property /////// became required for the status
- info
  the response property /////// became required for the status
- info
  the response's property default value PRIVATELY_OWNED was added for the status
- info
  removed the FUND enum value from the /////// response property for the response status
- info
  removed the MAJORITY_OWNED_SUBSIDIARY_OF_FI_OR_NBFI enum value from the /////// response property for the response status
- info
  removed the MAJORITY_OWNED_SUBSIDIARY_OF_PUBLICLY_LISTED_COMPANY enum value from the /////// response property for the response status
- info
  removed the OWNED_BY_TRUST enum value from the /////// response property for the response status
- info
  removed the PRIVATELY_OWNED enum value from the /////// response property for the response status
- info
  removed the PUBLICLY_LISTED_COMPANY enum value from the /////// response property for the response status
- info
  removed the WHOLLY_OWNED_SUBSIDIARY_OF_FI_OR_NBFI enum value from the /////// response property for the response status
- info
  removed the WHOLLY_OWNED_SUBSIDIARY_OF_PUBLICLY_LISTED_COMPANY enum value from the /////// response property for the response status
- info
  removed subschema #1 from the // response property oneOf list for the response status
- info
  removed subschema #1 from the // response property oneOf list for the response status
- info
  removed from the // response property oneOf list for the response status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status

Operation history