Get account holder document upload status

Account Holder Document Upload

Parameters

account_holder_token

Type: uuid
Required: Yes
Globally unique identifier for the account holder.

document_token

Type: uuid
Required: Yes
Globally unique identifier for the document.

Response

200 OK

Object: Describes the document and the required document image uploads required to re-run KYC

Fields

token
- Type: uuid
- Required: Yes
  Globally unique identifier for the document.
account_holder_token
- Type: uuid
- Required: Yes
  Globally unique identifier for the account holder.
document_type
- Type: string
- Enum:
  - 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
entity_token
- Type: uuid
- Required: Yes
  Globally unique identifier for an entity.
required_document_uploads
- Type: array of objects
- Required: Yes
  Represents a single image of the document to upload.

required_document_uploads Object

image_type
- Type: string
- Enum:
  - FRONT
  - BACK
status
- Type: string
- Enum:
  - ACCEPTED
  - REJECTED
  - PENDING_UPLOAD
  - UPLOADED
  - PARTIAL_APPROVAL
status_reasons
- Type: array of objects
- Required: Yes
  Reasons for document image upload status that is not ACCEPTED.

Status Reasons

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
upload_url
- Type: string
- Required: Yes
  URL to upload document image to.
token
- Type: uuid
- Required: Yes
  Globally unique identifier for the document upload.
accepted_entity_status_reasons
- Type: array of strings
- Required: Yes
  A list of status reasons associated with a KYB account holder that have been satisfied by the document upload.
rejected_entity_status_reasons
- Type: array of strings
- Required: Yes
  A list of status reasons associated with a KYB account holder that have not been satisfied by the document upload.
created
- Type: date-time
- Required: Yes
  When the document upload was created.
updated
- Type: date-time
- Required: Yes
  When the document upload was last updated.

Error Codes

400 Bad Request

A parameter in the query given in the request does not match the valid queries for the endpoint.

401 Unauthorized

Error Type	Description
User has not been authenticated	Invalid or missing API key
API key is not active	The API key used is no longer active
Could not find API key	The API key provided is not associated with any user
Please provide API key in Authorization header	The Authorization header is not in the request
Please provide API key in the form Authorization: [api-key]	The Authorization header is not formatted properly
Insufficient privileges.	Issuing API key required
Insufficient privileges to create virtual cards.	Creating virtual cards requires an additional privilege

404 Not Found

The specified resource was not found.

429 Too Many Requests

Client has exceeded the number of allowed requests in a given time period.

Sample Request

curl --request GET \
  --url https://sandbox.lithic.com/v1/account_holders/account_holder_token/documents/document_token \
  --header 'accept: application/json'

Sample Response

{
  "token": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "account_holder_token": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "document_type": "DRIVERS_LICENSE",
  "entity_token": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "required_document_uploads": [
    {
      "image_type": "FRONT",
      "status": "ACCEPTED",
      "status_reasons": [
        "DOCUMENT_MISSING_REQUIRED_DATA"
      ],
      "upload_url": "string",
      "token": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "accepted_entity_status_reasons": [
        "string"
      ],
      "rejected_entity_status_reasons": [
        "string"
      ],
      "created": "2026-07-18T03:11:38.871Z",
      "updated": "2026-07-18T03:11:38.871Z"
    }
  ]
}