---
title: "Get account holder document upload status"
method: GET
path: "/v1/account_holders/{account_holder_token}/documents/{document_token}"
tags: ["Account Holder"]
---

# Get account holder document upload status

`GET /v1/account_holders/{account_holder_token}/documents/{document_token}`

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`.

## Path parameters

- `account_holder_token` string, uuid, required
- `document_token` string, uuid, required

## Response `200`

OK

- Document — Describes the document and the required document image uploads required to re-run KYC
  - `token` string, uuid, required — Globally unique identifier for the document.
  - `account_holder_token` string, 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_token` string, uuid, required — Globally unique identifier for an entity.
  - `required_document_uploads` object[], required — Represents a single image of the document to upload.
    - `image_type` 'FRONT' | 'BACK', required — Type of image to upload.
    - `status` 'ACCEPTED' | 'REJECTED' | 'PENDING_UPLOAD' | 'UPLOADED' | 'PARTIAL_APPROVAL', required — Status of an account holder's document upload.
    - `status_reasons` DocumentUploadStatusReasons[], required — Reasons for document image upload status.
    - `upload_url` string, required — URL to upload document image to. Note that the upload URLs expire after 7 days. If an upload URL expires, you can refresh the URLs by retrieving the document upload from `GET /account_holders/{account_holder_token}/documents`.
    - `token` string, uuid, required — Globally unique identifier for the document upload.
    - `accepted_entity_status_reasons` string[], required — A list of status reasons associated with a KYB account holder that have been satisfied by the document upload
    - `rejected_entity_status_reasons` string[], required — A list of status reasons associated with a KYB account holder that have not been satisfied by the document upload
    - `created` string, date-time, required — When the document upload was created
    - `updated` string, date-time, required — When the document upload was last updated

## Other responses

- `400` — A parameter in the query given in the request does not match the valid queries for the endpoint.
- `401` — | | | |---|---| | 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](https://lithic.com/contact) | | Insufficient privileges to create virtual cards. | Creating virtual cards requires an additional privilege | Reach out at [lithic.com/contact](https://lithic.com/contact) |
- `404` — The specified resource was not found.
- `429` — Client has exceeded the number of allowed requests in a given time period. | | | |---|---| | 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 |

---

[API](https://skmtc.net/lithic-com/apis/lithic-developer-api.md) · [All operations](https://skmtc.net/lithic-com/apis/lithic-developer-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lithic-com/lithic-developer-api/revisions/53ab5d4e2adb/schema)