Document Types

When uploading verification documents to Lumx, the type field must match one of the values below. The right document depends on the customer type (INDIVIDUAL vs BUSINESS) and the stage of verification. For the full flow, see Identity Verification, Individual verification, and Business verification.

Identity documents (individuals)

Used for KYC. Most require a side field (FRONT_SIDE or BACK_SIDE).

Code	Description	Side required
`ID_CARD`	National identity card or equivalent government-issued ID.	Yes
`PASSPORT`	Passport biographic page.	Yes
`DRIVERS_LICENSE`	Driver’s license.	Yes
`SELFIE`	Live photo of the individual for biometric matching.	No

Proof of address

Code	Description
`PROOF_OF_ADDRESS`	Generic proof-of-address document.
`BANK_STATEMENT`	Recent bank statement (typically within the last 90 days).
`DELIVERY_RECEIPT`	Postal or courier delivery receipt showing the customer’s address.

Financial documents

Code	Description
`INCOME_TAX_RETURN`	Personal or corporate tax return.
`SIGNED_BALANCE_SHEET`	Signed balance sheet for a business customer.
`SIGNED_INCOME_STATEMENT`	Signed income statement (P&L) for a business customer.

Corporate documents (businesses)

Used for KYB.

Code	Description
`INCORPORATION_ARTICLES`	Articles of incorporation or equivalent constitutional document.
`SHAREHOLDER_REGISTRY`	Registry listing shareholders and their ownership.
`DIRECTORS_REGISTRY`	Registry listing directors and officers.
`SIGNED_CORPORATE_STRUCTURE_CHART`	Signed chart showing the corporate structure and ownership tree.
`POWER_OF_ATTORNEY`	Power of attorney granting representation authority.
`REGULATED_ACTIVITY_DOCUMENT`	License or proof of regulated activity (required when `isRegulatedActivity: true`).

Other

Code	Description
`ADDITIONAL_INFORMATION`	Used to attach extra context requested via RFI.
`OTHER`	Anything that doesn’t fit a category above. Include context in the request.

Document status

Once uploaded, each document moves through this lifecycle:

Status	Meaning
`NOT_SENT`	Required document hasn’t been uploaded yet.
`PENDING`	Document is queued for review.
`APPROVED`	Document accepted.
`TEMPORARY_REJECTION`	Document needs to be resubmitted. Reasons come back in the verification response. See Request for Information.
`FINAL_REJECTION`	Document permanently rejected. The customer cannot proceed.

Document-level status uses TEMPORARY_REJECTION even though customer-level verification status was renamed to RFI in v2.11.0. The two fields are independent.

Uploads are capped at 50 MB. Accepted file formats: JPG, PNG, and PDF.

Identity Verification

KYC and KYB requirements per customer type.

Individual verification

Step-by-step KYC integration.

Business verification

Step-by-step KYB integration.

Request for Information

Resolve RFIs raised on documents during review.

Get Started

Core Concepts

Compliance

Developer

Additional Information

Document Types

Identity documents (individuals)

Proof of address

Financial documents

Corporate documents (businesses)

Other

Document status

Identity Verification

Individual verification

Business verification

Request for Information

​Identity documents (individuals)

​Proof of address

​Financial documents

​Corporate documents (businesses)

​Other

​Document status

​Related resources

Identity Verification

Individual verification

Business verification

Request for Information

Identity documents (individuals)

Proof of address

Financial documents

Corporate documents (businesses)

Other

Document status

Related resources