Sign in

v66

latestOpenAPI 3.1.0Apache 2.0raw.githubusercontent.com2026-08-042174421.1 MB
Account Holder

Get an individual or business account holder

Get an Individual or Business Account Holder and/or their KYC or KYB evaluation status.

get/v1/account_holders/{account_holder_token}

Path parameters

account_holder_tokenstring uuid required

Globally unique identifier for the account holder.

Response

OK

account_tokenstring uuid

Globally unique identifier for the account.

business_account_tokenstring uuid

Only applicable for customers using the KYC-Exempt workflow to enroll authorized users of businesses. Pass the account_token of the enrolled business associated with the AUTHORIZED_USER in this field.

createdstring date-time required

Timestamp of when the account holder was created.

emailstring

(Deprecated. Use control_person.email when user_type == "BUSINESS". Use individual.phone_number when user_type == "INDIVIDUAL".) Primary email of Account Holder.

exemption_type'AUTHORIZED_USER' | 'PREPAID_CARD_USER'

The type of KYC exemption for a KYC-Exempt Account Holder.

external_idstring

Customer-provided token that indicates a relationship with an object outside of the Lithic ecosystem.

naics_codestring

Only present when user_type == "BUSINESS". 6-digit North American Industry Classification System (NAICS) code for the business.

nature_of_businessstring

Only present when user_type == "BUSINESS". User-submitted description of the business.

phone_numberstring

(Deprecated. Use control_person.phone_number when user_type == "BUSINESS". Use individual.phone_number when user_type == "INDIVIDUAL".) Primary phone of Account Holder, entered in E.164 format.

status'ACCEPTED' | 'PENDING_REVIEW' | 'PENDING_DOCUMENT' | 'PENDING_RESUBMIT' | 'REJECTED'

(Deprecated. Use verification_application.status instead)

KYC and KYB evaluation states.

Note:

  • PENDING_REVIEW is only applicable for the KYB_BASIC workflow.
status_reasonsstring[]

(Deprecated. Use verification_application.status_reasons)

Reason for the evaluation status.

tokenstring uuid required

Globally unique identifier for the account holder.

user_type'BUSINESS' | 'INDIVIDUAL'

The type of Account Holder. If the type is "INDIVIDUAL", the "individual" attribute will be present. If the type is "BUSINESS" then the "business_entity", "control_person", "beneficial_owner_individuals", "naics_code", "nature_of_business", and "website_url" attributes will be present.

website_urlstring

Only present when user_type == "BUSINESS". Business's primary website.

Example response

{
  "beneficial_owner_individuals": [
    {
      "address": {
        "address1": "123 Old Forest Way",
        "city": "Omaha",
        "country": "USA",
        "postal_code": "68022",
        "state": "NE"
      },
      "dob": "1991-03-08 08:00:00",
      "email": "tom@middle-earth.com",
      "first_name": "Tom",
      "last_name": "Bombadil",
      "phone_number": "+15555555555"
    }
  ],
  "business_entity": {
    "address": {
      "address1": "123 Old Forest Way",
      "city": "Omaha",
      "country": "USA",
      "postal_code": "68022",
      "state": "NE"
    },
    "government_id": "114-123-1513",
    "legal_business_name": "Acme, Inc.",
    "phone_numbers": [
      "+15555555555"
    ]
  },
  "control_person": {
    "address": {
      "address1": "123 Old Forest Way",
      "city": "Omaha",
      "country": "USA",
      "postal_code": "68022",
      "state": "NE"
    },
    "dob": "1991-03-08 08:00:00",
    "email": "tom@middle-earth.com",
    "first_name": "Tom",
    "last_name": "Bombadil",
    "phone_number": "+15555555555"
  },
  "email": "+15555555555",
  "individual": {
    "address": {
      "address1": "123 Old Forest Way",
      "city": "Omaha",
      "country": "USA",
      "postal_code": "68022",
      "state": "NE"
    },
    "dob": "1991-03-08 08:00:00",
    "email": "tom@middle-earth.com",
    "first_name": "Tom",
    "last_name": "Bombadil",
    "phone_number": "+15555555555"
  },
  "phone_number": "+15555555555"
}