Account Holder Token

Fields

• account_holder_token
  • Type: uuid
  • Required: True
  • Description: Globally unique identifier for the account holder.

Response

200 OK

• account_token

  • Type: uuid
  • Description: Globally unique identifier for the account.

• beneficial_owner_individuals

  • Type: array of objects
  • Length: ≥ 0
  • Description: Only present when user_type == "BUSINESS". A list of all direct and indirect individuals with 25% or more ownership in the company.

• created

  • Type: date-time
  • Required: True
  • Description: Timestamp of when the account holder was created.

• user_type

  • Type: string
  • Enum: BUSINESS, INDIVIDUAL
  • Description: The type of Account Holder.

Individual Details (user_type == "INDIVIDUAL")

• individual
  • Type: object
  • Description: Information about the individual for which the account is being opened and KYC is being run.
  • Fields:
    • address
      • Type: object
      • Required: True
      • Description: Individual's current address.
    • dob
      • Type: string
      • Required: True
      • Description: Individual's date of birth, as an RFC 3339 date.
    • email
      • Type: string
      • Required: True
      • Description: Individual's email address.
    • first_name
      • Type: string
      • Required: True
      • Description: Individual's first name.
    • last_name
      • Type: string
      • Required: True
      • Description: Individual's last name.
    • phone_number
      • Type: string
      • Required: True
      • Description: Individual's phone number, entered in E.164 format.

Response Example

{
  "token": "b68b7424-aa69-4cbc-a946-30d90181b621",
  "account_token": "6b67b340-ed11-4463-a33d-0d7f7fdcd28c",
  "business_account_token": "5310469f-3a16-44ce-89f8-cdc4446fcfdf",
  "external_id": "",
  "created": "2024-01-11T19:50:36.105449",
  "user_type": "INDIVIDUAL",
  "verification_application": {
    "created": "2024-01-11T19:50:36.105449",
    "updated": "2024-01-11T19:50:36.105449",
    "status": "ACCEPTED",
    "status_reasons": []
  },
  "individual": {
    "address": {
      "address1": "451 New Forest Way",
      "city": "Springfield",
      "state": "IL",
      "postal_code": "68022",
      "country": "USA"
    },
    "dob": "1991-03-08T08:00:00Z",
    "email": "john@appleseed.com",
    "first_name": "John",
    "last_name": "Appleseed",
    "phone_number": "+15555555555",
    "entity_token": "fd771a07-c5c2-42f3-a53c-a6c79c6c0d07"
  },
  "email": "john@appleseed.com",
  "phone_number": "+15555555555",
  "status": "ACCEPTED"
}