Documents
Upload Account Document
Attach an entity (business) document to the account as a base64 data URI
POST
Documents carry the entity (business) file evidence behind KYB — e.g. certificate of incorporation, proof of address, board resolution. They attach to an account. Files are submitted as base64 data URIs. The complete JSON request body is limited to 21 MiB, including base64 expansion and JSON/data-URI overhead; an oversized request returns
413. In practice, the largest raw file is approximately 15.75 MiB and may be slightly smaller depending on metadata.
Uploading a document accepts the file with status staged and recomputes the account’s onboarding requirements. Once all requirements are complete, Hop automatically submits the account — including its staged documents — for verification review, moving the account to under_review and each document to submitted. Uploads are blocked once the account’s kyc_status is terminal (approved / rejected).
These endpoints cover entity documents only; an associated person’s identity documents are captured inside their Verification Session, not uploaded here.
This endpoint attaches an entity (business) document to the account and recomputes onboarding requirements. Fails with
422 when kyc_status is terminal.
Path Parameters
string
required
Id of the Platform customer (e.g.
cus_…).string
required
Id of the account (e.g.
acct_…).Request Body
string
required
Requirement key returned by GET Account (
requirements.missing[].key / requirements.issues[].key) that this document satisfies. Every upload must claim a key the account can satisfy — an unknown key, or a type the claimed requirement does not accept, is rejected with 422 listing the allowed values.enum
required
Account document type — see the enum table above.
string
required
Document file as a base64 data URI (e.g.
data:application/pdf;base64,...). The complete request body is limited to 21 MiB, including base64 and JSON overhead; the practical raw-file maximum is approximately 15.75 MiB.string | null
Original file name, for your own reference. Max 255 characters.
Response
Returns200 with the new resource’s id. Use Get Document to retrieve the full object.
string
Id of the newly created document (e.g.
doc_…).