Retrieve

Get an individual or business account holder

get/v1/account_holders/{account_holder_token}

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

Path Parameters

account_holder_tokenstring

formatuuid

Returns

tokenstringcreatedstringaccount_tokenstringbeneficial_owner_entitiesarray of objectbeneficial_owner_individualsarray of objectbusiness_account_tokenstringbusiness_entityobjectcontrol_personobjectemailstringexemption_typeenumexternal_idstringindividualobjectnature_of_businessstringphone_numberstringrequired_documentsarray of RequiredDocumentstatusenumstatus_reasonsarray of enumuser_typeenumverification_applicationobjectwebsite_urlstringAccountHolder

Request example Request

curl https://api.lithic.com/v1/account_holders/$ACCOUNT_HOLDER_TOKEN \
    -H "Authorization: $LITHIC_API_KEY"

200 Example

{
  "token": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
  "created": "2019-12-27T18:11:19.117Z",
  "account_token": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
  "beneficial_owner_entities": [
    {
      "address": {
        "address1": "123 Old Forest Way",
        "city": "Omaha",
        "country": "USA",
        "postal_code": "68022",
        "state": "NE",
        "address2": "address2"
      },
      "dba_business_name": "dba_business_name",
      "entity_token": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
      "government_id": "114-123-1513",
      "legal_business_name": "Acme, Inc.",
      "phone_numbers": [
        "+15555555555"
      ],
      "parent_company": "parent_company"
    }
  ],
  "beneficial_owner_individuals": [
    {
      "address": {
        "address1": "123 Old Forest Way",
        "city": "Omaha",
        "country": "USA",
        "postal_code": "68022",
        "state": "NE",
        "address2": "address2"
      },
      "dob": "1991-03-08 08:00:00",
      "email": "tom@middle-earth.com",
      "entity_token": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
      "first_name": "Tom",
      "last_name": "Bombadil",
      "phone_number": "+15555555555"
    }
  ],
  "business_account_token": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
  "business_entity": {
    "address": {
      "address1": "123 Old Forest Way",
      "city": "Omaha",
      "country": "USA",
      "postal_code": "68022",
      "state": "NE",
      "address2": "address2"
    },
    "dba_business_name": "dba_business_name",
    "entity_token": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
    "government_id": "114-123-1513",
    "legal_business_name": "Acme, Inc.",
    "phone_numbers": [
      "+15555555555"
    ],
    "parent_company": "parent_company"
  },
  "control_person": {
    "address": {
      "address1": "123 Old Forest Way",
      "city": "Omaha",
      "country": "USA",
      "postal_code": "68022",
      "state": "NE",
      "address2": "address2"
    },
    "dob": "1991-03-08 08:00:00",
    "email": "tom@middle-earth.com",
    "entity_token": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
    "first_name": "Tom",
    "last_name": "Bombadil",
    "phone_number": "+15555555555"
  },
  "email": "+15555555555",
  "exemption_type": "AUTHORIZED_USER",
  "external_id": "external_id",
  "individual": {
    "address": {
      "address1": "123 Old Forest Way",
      "city": "Omaha",
      "country": "USA",
      "postal_code": "68022",
      "state": "NE",
      "address2": "address2"
    },
    "dob": "1991-03-08 08:00:00",
    "email": "tom@middle-earth.com",
    "entity_token": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
    "first_name": "Tom",
    "last_name": "Bombadil",
    "phone_number": "+15555555555"
  },
  "nature_of_business": "nature_of_business",
  "phone_number": "+15555555555",
  "required_documents": [
    {
      "entity_token": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
      "status_reasons": [
        "string"
      ],
      "valid_documents": [
        "string"
      ]
    }
  ],
  "status": "ACCEPTED",
  "status_reasons": [
    "ADDRESS_VERIFICATION_FAILURE"
  ],
  "user_type": "BUSINESS",
  "verification_application": {
    "created": "2019-12-27T18:11:19.117Z",
    "status": "ACCEPTED",
    "status_reasons": [
      "ADDRESS_VERIFICATION_FAILURE"
    ],
    "updated": "2019-12-27T18:11:19.117Z"
  },
  "website_url": "website_url"
}