v66

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

Simulate an account holder document upload's review

Simulates a review for an account holder document upload.

post/v1/simulate/account_holders/enrollment_document_review

Request body

document_upload_tokenstring required

The account holder document upload which to perform the simulation upon.

status'UPLOADED' | 'ACCEPTED' | 'REJECTED' | 'PARTIAL_APPROVAL' required

An account holder document's upload status for use within the simulation.

status_reason'DOCUMENT_MISSING_REQUIRED_DATA' | 'DOCUMENT_UPLOAD_TOO_BLURRY' | 'FILE_SIZE_TOO_LARGE' | 'INVALID_DOCUMENT_TYPE' | 'INVALID_DOCUMENT_UPLOAD' | 'INVALID_ENTITY' | 'DOCUMENT_EXPIRED' | 'DOCUMENT_ISSUED_GREATER_THAN_30_DAYS' | 'DOCUMENT_TYPE_NOT_SUPPORTED' | 'UNKNOWN_FAILURE_REASON' | 'UNKNOWN_ERROR'

The status reasons for an account holder document upload that is not ACCEPTED

accepted_entity_status_reasonsstring[]

A list of status reasons associated with a KYB account holder in PENDING_REVIEW

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