When uploading verification documents to Lumx, theDocumentation Index
Fetch the complete documentation index at: https://docs.lumx.io/llms.txt
Use this file to discover all available pages before exploring further.
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 aside 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.
Related resources
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.