Sign in

v1

latestOpenAPI 3.1.0Proprietary2026-07-2464170247.4 KB
Onboarding V2

Get Business Account

Retrieve the current state of a business account.

get/v2/accounts/{main_account_id}/businesses/{sub_account_id}

Path parameters

main_account_idstring required

Main account id in the form BZ-XXXX-XXXX.

sub_account_idstring required

Business child account ID

Response

Business fetched successfully.

account_idstring
parent_account_idstring
external_idstring nullable

Partner-supplied identifier for the business in the partner's own system.

legal_namestring required

Legal name of the business as registered with the relevant tax or company authority.

descriptionstring nullable

Free-form description of the nature of the business and its activities.

type'CORPORATION' | 'LLC' | 'PARTNERSHIP' | 'SOLE_PROPRIETORSHIP' | 'INVESTMENT_FUND' | 'SOCIETIES' | 'TRUST' | 'GOVERNMENT' | 'DAO'
industry'ACCOMMODATION_AND_FOOD_SERVICE' | 'ADMINISTRATIVE_SUPPORT_SERVICES' | 'ADULT_ENTERTAINMENT' | 'AGRICULTURE_FORESTRY_FISHING' | 'ARMS_INDUSTRY' | 'ARTS_ENTERTAINMENT_RECREATION' | 'BANKING_RFI' | 'BROKERAGE_OTC' | 'CEX_DEX' | 'CONSTRUCTION' | 'OIL_GAS' | 'CRYPTO_ATM' | 'CRYPTO_CARDS' | 'CRYPTO_GIFT_CARDS' | 'CRYPTO_MINING' | 'CRYPTO_CUSTODY' | 'DEFI' | 'EDUCATION' | 'FAMILY_OFFICE' | 'DAO_FOUNDATION' | 'GAMBLING' | 'GAMING_METAVERSE' | 'MANUFACTURING' | 'WHOLESALERS' | 'HEALTHCARE' | 'INVESTMENT_FUND' | 'HOLDING_COMPANY' | 'MARIJUANA' | 'MEDIA' | 'MINING_EXTRACTION' | 'MSB_PSP' | 'NFT_MARKETPLACE' | 'NON_BANK_FI' | 'NON_CUSTODIAL_WALLET' | 'P2P_MERCHANTS' | 'PAWN_SHOPS' | 'PERSONAL_INVESTMENT' | 'PLAY_TO_EARN' | 'PRECIOUS_METALS' | 'PROFESSIONAL_SERVICES' | 'PROP_TRADING_MARKET_MAKING' | 'PUBLIC_ADMIN' | 'REAL_ESTATE' | 'RETAIL_ELECTRONICS' | 'RETAIL_FNB' | 'RETAIL_JEWELRY' | 'RETAIL_OTHER' | 'PHARMACEUTICALS' | 'SCIENTIFIC_TECHNICAL' | 'SOFTWARE_DEVELOPMENT' | 'SOVEREIGN_WEALTH' | 'STABLECOIN_ISSUER' | 'TECHNOLOGY_ECOMMERCE' | 'TOBACCO' | 'TRANSPORTATION' | 'TRAVEL_AGENCIES_AND_TOURISM' | 'UNLICENSED_GAMBLING' | 'UTILITIES' | 'VENTURE_CAPITAL_PE' | 'WEB3_CRYPTO_NATIVE'
business_emailstring required

Primary contact email for the business.

compliance_emailstring nullable

Dedicated compliance contact email for the business, when distinct from business_email.

websitestring nullable

Public website of the business.

status'DRAFT' | 'PROCESSING' | 'ACTION_REQUIRED' | 'UNDER_REVIEW' | 'APPROVED' | 'REJECTED' required

Onboarding lifecycle status of a business sub-account.

  • DRAFT — sub-account initiated but not yet submitted for review.
  • PROCESSING — submitted and being prepared for review.
  • ACTION_REQUIRED — a Request for Information (RFI) is open and waiting on the partner to respond. See RFI Handling.
  • UNDER_REVIEW — active manual compliance review is in progress or provisioning.
  • APPROVED — terminal status; the sub-account is active and ready to transact.
  • REJECTED — terminal status; the sub-account cannot be activated.
submitted_atstring nullable

Timestamp at which the sub-account was last submitted for compliance review (RFC 3339 format). null while the sub-account is still in initial onboarding.

created_atstring required

Timestamp at which the sub-account was initiated (RFC 3339 format).

updated_atstring required

Timestamp of the most recent update to the sub-account or any of its related entities (RFC 3339 format).

Example response

{
  "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"
        }
      }
    }
  ]
}