Skip to content
Stainless Stainless Stainless SDKs

Upload Document

Initiate account holder document upload
post/v1/account_holders/{account_holder_token}/documents

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.

Uploaded images must either be a jpg or png file, and each 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.

Path Parameters
account_holder_tokenstring
formatuuid
Body Parameters
document_typeenum
Accepts one of the following: "EIN_LETTER", "TAX_RETURN", "OPERATING_AGREEMENT", 16 more

The type of document to upload

Hide ParametersShow Parameters
"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"
entity_tokenstring

Globally unique identifier for the entity.

formatuuid
Returns
tokenstringaccount_holder_tokenstringdocument_typeenumentity_tokenstringrequired_document_uploadsarray of objectDocument
Request example Request
curl https://api.lithic.com/v1/account_holders/$ACCOUNT_HOLDER_TOKEN/documents \
    -H 'Content-Type: application/json' \
    -H "Authorization: $LITHIC_API_KEY" \
    -d '{
      "document_type": "EIN_LETTER",
      "entity_token": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e"
    }'
200 Example
{
  "token": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
  "account_holder_token": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
  "document_type": "DRIVERS_LICENSE",
  "entity_token": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
  "required_document_uploads": [
    {
      "token": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
      "accepted_entity_status_reasons": [
        "string"
      ],
      "created": "2019-12-27T18:11:19.117Z",
      "image_type": "FRONT",
      "rejected_entity_status_reasons": [
        "string"
      ],
      "status": "ACCEPTED",
      "status_reasons": [
        "DOCUMENT_MISSING_REQUIRED_DATA"
      ],
      "updated": "2019-12-27T18:11:19.117Z",
      "upload_url": "upload_url"
    }
  ]
}