Sign in

v3

latestOpenAPI 3.0.32026-07-31489099.0 KB
Accounts

Creates an account managed by organization

post/accounts

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",
    "street_line_1": "100 Example St.",
    "street_line_2": "Suite 500",
    "zip": "90001"
  },
  "beneficial_owners": [
    {
      "address": {
        "city": "Springfield",
        "country": "US",
        "street_line_1": "100 Example St.",
        "street_line_2": "Suite 500",
        "zip": "90001"
      },
      "dob": "YYYY-MM-DD",
      "email": "a@b.com",
      "first_name": "John",
      "last_name": "Doe",
      "ownership_percentage": 40,
      "phone_number": "515-555-1212",
      "ssn": "123-45-6789"
    }
  ],
  "business_controller": {
    "address": {
      "city": "Springfield",
      "country": "US",
      "street_line_1": "100 Example St.",
      "street_line_2": "Suite 500",
      "zip": "90001"
    },
    "dob": "YYYY-MM-DD",
    "email": "a@b.com",
    "first_name": "John",
    "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",
  "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"
}