BRbrale
Accounts

Creates an account managed by organization

Changed on
post/accounts

Request

  • Base URL
    https://api.brale.xyz
  • Auth
    OAuth 2
    Client credentials
    Token URL: https://auth.brale.xyz/oauth2/token scopes: accounts:write

Request body

account_type'custodial' | 'transactional'
business_namestring
doc_submission_idsID[] nullable

Optional staged document submission IDs to link at account creation

einstring
emailstring
entity_type'business' | 'individual'
phone_numberstring nullable
verification_mode'standard' | 'reliance' | 'bypass'
websitestring

Example request

{
  "address": {
    "city": "Springfield",
    "country": "US",
    "state": "CA",
    "street_line_1": "100 Example St.",
    "street_line_2": "Suite 500",
    "zip": "90001"
  },
  "beneficial_owners": [
    {
      "address": {
        "city": "London",
        "country": "GB",
        "state": "England",
        "street_line_1": "10 Downing St",
        "street_line_2": "Flat 2",
        "zip": "SW1A 2AA"
      },
      "dob": "YYYY-MM-DD",
      "email": "a@b.com",
      "first_name": "John",
      "identity": {
        "number": "123-45-6789",
        "type": "SSN9"
      },
      "last_name": "Doe",
      "ownership_percentage": 40,
      "phone_number": "515-555-1212",
      "ssn": "123-45-6789"
    }
  ],
  "business_controller": {
    "address": {
      "city": "London",
      "country": "GB",
      "state": "England",
      "street_line_1": "10 Downing St",
      "street_line_2": "Flat 2",
      "zip": "SW1A 2AA"
    },
    "dob": "YYYY-MM-DD",
    "email": "a@b.com",
    "first_name": "John",
    "identity": {
      "number": "123-45-6789",
      "type": "SSN9"
    },
    "last_name": "Doe",
    "ownership_percentage": 40,
    "phone_number": "515-555-1212",
    "ssn": "123-45-6789"
  },
  "business_name": "My Customer",
  "doc_submission_ids": [
    "2VZvtmVc2j3gQ80CTlcuQXbGrwC"
  ],
  "ein": "123456789",
  "email": "a@b.com",
  "individual": {
    "address": {
      "city": "London",
      "country": "GB",
      "state": "England",
      "street_line_1": "10 Downing St",
      "street_line_2": "Flat 2",
      "zip": "SW1A 2AA"
    },
    "country": "US",
    "date_of_birth": "1990-01-31",
    "email": "jane@example.com",
    "first_name": "Jane",
    "identity": {
      "number": "123-45-6789",
      "type": "SSN9"
    },
    "last_name": "Doe",
    "phone_number": "515-555-1212"
  },
  "phone_number": "515-555-1212",
  "regulatory_profile": {
    "license_number": "M12345678",
    "regulator": "FINTRAC"
  },
  "tos_attestation": {
    "accepted_at": "2020-01-01T12:00:00Z",
    "ip": "203.0.113.42",
    "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:138.0) Gecko/20100101 Firefox/138.0",
    "version": "2025-04-01"
  },
  "website": "https://example.com"
}

Response

OK

createdstring date-time

ISO-8601 timestamp that includes date and time

idstring required

ID of the resource

namestring required
status'complete' | 'pending' | 'rejected' required
updatedstring date-time

ISO-8601 timestamp that includes date and time

Example response

{
  "created": "2020-01-01T12:00:00Z",
  "id": "2VZvtmVc2j3gQ80CTlcuQXbGrwC",
  "name": "My Account",
  "updated": "2020-01-01T12:00:00Z"
}

Changes

  • daa90a3368cdRevision changes
    • info

      added the new optional request property

  • 9c74b137981bRevision changes
    • breaking

      removed the enum value AK of the request property /

    • breaking

      removed the enum value AL of the request property /

    • breaking

      removed the enum value AR of the request property /

    • breaking

      removed the enum value AS of the request property /

    • breaking

      removed the enum value AZ of the request property /

    • breaking

      removed the enum value CA of the request property /

    • breaking

      removed the enum value CO of the request property /

    • breaking

      removed the enum value CT of the request property /

    • breaking

      removed the enum value DC of the request property /

    • breaking

      removed the enum value DE of the request property /

    • breaking

      removed the enum value FL of the request property /

    • breaking

      removed the enum value GA of the request property /

    • breaking

      removed the enum value GU of the request property /

    • breaking

      removed the enum value HI of the request property /

    • breaking

      removed the enum value IA of the request property /

    • breaking

      removed the enum value ID of the request property /

    • breaking

      removed the enum value IL of the request property /

    • breaking

      removed the enum value IN of the request property /

    • breaking

      removed the enum value KS of the request property /

    • breaking

      removed the enum value KY of the request property /

    • breaking

      removed the enum value LA of the request property /

    • breaking

      removed the enum value MA of the request property /

    • breaking

      removed the enum value MD of the request property /

    • breaking

      removed the enum value ME of the request property /

    • breaking

      removed the enum value MI of the request property /

    • breaking

      removed the enum value MN of the request property /

    • breaking

      removed the enum value MO of the request property /

    • breaking

      removed the enum value MP of the request property /

    • breaking

      removed the enum value MS of the request property /

    • breaking

      removed the enum value MT of the request property /

    • breaking

      removed the enum value NC of the request property /

    • breaking

      removed the enum value ND of the request property /

    • breaking

      removed the enum value NE of the request property /

    • breaking

      removed the enum value NH of the request property /

    • breaking

      removed the enum value NJ of the request property /

    • breaking

      removed the enum value NM of the request property /

    • breaking

      removed the enum value NV of the request property /

    • breaking

      removed the enum value NY of the request property /

    • breaking

      removed the enum value OH of the request property /

    • breaking

      removed the enum value OK of the request property /

    • breaking

      removed the enum value OR of the request property /

    • breaking

      removed the enum value PA of the request property /

    • breaking

      removed the enum value PR of the request property /

    • breaking

      removed the enum value RI of the request property /

    • breaking

      removed the enum value SC of the request property /

    • breaking

      removed the enum value SD of the request property /

    • breaking

      removed the enum value TN of the request property /

    • breaking

      removed the enum value TX of the request property /

    • breaking

      removed the enum value UT of the request property /

    • breaking

      removed the enum value VA of the request property /

    • breaking

      removed the enum value VI of the request property /

    • breaking

      removed the enum value VT of the request property /

    • breaking

      removed the enum value WA of the request property /

    • breaking

      removed the enum value WI of the request property /

    • breaking

      removed the enum value WV of the request property /

    • breaking

      removed the enum value WY of the request property /

    • info

      the request property / became optional