What it is
Analyze Document reads a PDF, JPG, or PNG with AI, checks it against the rules for its document type, and returns an approval_rate of low, medium, or high plus a short reason. Use it to pre-screen customer documents before submitting them for KYC, so you can prompt for a better file early instead of waiting for a rejection.
The analysis is a signal, not a decision. It does not approve or reject KYC; the official outcome still comes from the verification flow.
Prerequisites
Document types
Pass the type that matches the document. It selects the rule set used for the analysis.
| Type | Use for |
|---|---|
identity_document | National ID, driver's license, or residence permit |
passport | Passport |
selfie | Selfie / liveness photo |
proof_of_address | Utility bill, bank statement, or lease as proof of address |
incorporation_document | Company incorporation / registration document |
proof_of_ownership | Proof of company ownership |
source_of_funds | Source of funds evidence |
proof_of_income | Proof of income |
bank_statement | Bank statement |
financial_statement | Company financial statement |
tax_return | Tax return |
invoice | Invoice |
transaction_document | Transaction supporting document |
Optional metadata
Pass metadata as a JSON string of values you already collected to cross-check them against the document. A clear mismatch caps the rating at low and the reason explains it.
| Field | Checked against |
|---|---|
full_name | Name on the document |
entity_name | Company name on the document |
date_of_birth | Date of birth on the document |
address | Address on the document |
id_number | ID / document number |
requested_per_transaction | Capacity shown supports the per-transaction limit (USD) |
requested_daily | Capacity shown supports the daily limit (USD) |
requested_monthly | Capacity shown supports the monthly limit (USD) |
Only send fields you have already collected. Name, entity, date of birth, address, and ID are matched against the document; requested limits are checked for sufficient capacity, with non-USD amounts converted at a reasonable rate.
Analyze a document
You can check the required fields in the BlindPay API Docs.
The file must be a PDF, JPG, or PNG of up to 5MB. The real format is detected from the file contents, so a mislabeled extension is rejected.
YOUR_SECRET_TOKEN with your API key and in_000000000000 with your instance ID. Each tab shows the type with the metadata fields that fit it. The file should be a standard File format.
The response tells you how confident the analysis is and why: