Get account holder document uploads

Account Holder Document Uploads

Account Holder Token

UUID (required): Globally unique identifier for the account holder.

200 OK

Response Structure

data: array of objects

Data Object

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

Fields:

token (UUID, required): Globally unique identifier for the document.
account_holder_token (UUID, required): Globally unique identifier for the account holder.
document_type (string, enum, required): Type of documentation to be submitted for verification of an account holder. Possible values include:
- 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 (UUID, required): Globally unique identifier for an entity.
required_document_uploads (array of objects, required): Represents a single image of the document to upload.

Required Document Uploads Object

image_type (string, enum, required): Type of image to upload. Possible values: FRONT, BACK.
status (string, enum, required): Status of an account holder's document upload. Possible values include:
- ACCEPTED
- REJECTED
- PENDING_UPLOAD
- UPLOADED
- PARTIAL_APPROVAL
status_reasons (array of objects, required): Reasons for document image upload status that is not ACCEPTED. Possible reasons include:
- 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 (string, required): URL to upload document image to (expires after 7 days).
token (UUID, required): Globally unique identifier for the document upload.
accepted_entity_status_reasons (array of strings, required): Status reasons associated with a KYB account holder that have been satisfied by the document upload.
rejected_entity_status_reasons (array of strings, required): Status reasons associated with a KYB account holder that have not been satisfied by the document upload.
created (date-time, required): When the document upload was created.
updated (date-time, required): When the document upload was last updated.

400 Bad Request

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

401 Unauthorized

Error	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	Write access requires an Issuing API key. Reach out at lithic.com/contact
Insufficient privileges to create virtual cards.	Creating virtual cards requires an additional privilege

429 Too Many Requests

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

Error	Description
Rate limited, too many requests per second	User has exceeded their per second rate limit
Rate limited, reached daily limit	User has exceeded their daily rate limit
Rate limited, too many keys tried	One IP has queried too many different API keys

Example Request

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

Example Response

{
  "data": [
    {
      "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.013Z",
          "updated": "2026-07-18T03:11:38.013Z"
        }
      ]
    }
  ]
}