Sign in

v66

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

Initiate account holder document upload

Use this endpoint to identify which type of supported government-issued documentation you will upload for further verification. It will return two URLs to upload your document images to - one for the front image and one for the back image.

This endpoint is only valid for evaluations in a PENDING_DOCUMENT state.

Supported file types include jpg, png, and pdf. Each file must be less than 15 MiB. Once both required uploads have been successfully completed, your document will be run through KYC verification.

If you have registered a webhook, you will receive evaluation updates for any document submission evaluations, as well as for any failed document uploads.

Two document submission attempts are permitted via this endpoint before a REJECTED status is returned and the account creation process is ended. Currently only one type of account holder document is supported per KYC verification.

post/v1/account_holders/{account_holder_token}/documents

Path parameters

account_holder_tokenstring uuid required

Globally unique identifier for the account holder.

Request body

document_type'EIN_LETTER' | 'TAX_RETURN' | 'OPERATING_AGREEMENT' | 'CERTIFICATE_OF_FORMATION' | 'DRIVERS_LICENSE' | 'PASSPORT' | 'PASSPORT_CARD' | '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

The type of document to upload

entity_tokenstring uuid required

Globally unique identifier for the entity.

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"
    }
  ]
}