Sign in

v66

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

Get account holder document upload status

Check the status of an account holder document upload, or retrieve the upload URLs to process your image uploads.

Note that this is not equivalent to checking the status of the KYC evaluation overall (a document may be successfully uploaded but not be sufficient for KYC to pass).

In the event your upload URLs have expired, calling this endpoint will refresh them. Similarly, in the event a document upload has failed, you can use this endpoint to get a new upload URL for the failed image upload.

When a new account holder document upload is generated for a failed attempt, the response will show an additional entry in the required_document_uploads array in a PENDING state for the corresponding image_type.

get/v1/account_holders/{account_holder_token}/documents/{document_token}

Path parameters

account_holder_tokenstring uuid required

Globally unique identifier for the account holder.

document_tokenstring uuid required

Globally unique identifier for the document.

Response

OK

tokenstring uuid required

Globally unique identifier for the document.

account_holder_tokenstring uuid required

Globally unique identifier for the account holder.

document_type'DRIVERS_LICENSE' | 'PASSPORT' | 'PASSPORT_CARD' | 'EIN_LETTER' | 'TAX_RETURN' | 'OPERATING_AGREEMENT' | 'CERTIFICATE_OF_FORMATION' | 'CERTIFICATE_OF_GOOD_STANDING' | 'ARTICLES_OF_INCORPORATION' | 'ARTICLES_OF_ORGANIZATION' | 'BYLAWS' | 'GOVERNMENT_BUSINESS_LICENSE' | 'PARTNERSHIP_AGREEMENT' | 'SS4_FORM' | 'BANK_STATEMENT' | 'UTILITY_BILL_STATEMENT' | 'SSN_CARD' | 'ITIN_LETTER' | 'FINCEN_BOI_REPORT' required

Type of documentation to be submitted for verification of an account holder

entity_tokenstring uuid required

Globally unique identifier for an entity.

Example response

{
  "account_holder_token": "aab6ad9a-3630-4cd0-bbec-1a0fa5c7e149",
  "token": "f41c975e-cad8-4e4f-a5cb-cef92ed91083",
  "document_type": "EIN_LETTER",
  "entity_token": "b50a84c9-8e86-4016-b1c7-0b9f71d4bb84",
  "required_document_uploads": [
    {
      "image_type": "FRONT",
      "status": "PENDING_UPLOAD",
      "status_reasons": [],
      "upload_url": "https://lithic-document-verification-uploads.com",
      "token": "e254beee-67db-4d8c-b610-306ee07de886",
      "accepted_entity_status_reasons": [],
      "rejected_entity_status_reasons": [],
      "created": "2024-09-18T12:34:56Z",
      "updated": "2024-09-18T12:34:56Z"
    }
  ]
}