The Realtime Document Verification endpoint allows you to run quick, single-purpose document verification workflows via HTTP requests. This is ideal for fast validation of business documents like proof of address, incorporation certificates, and more.
For an interactive guide on testing document verification before API integration, see our Realtime Document Verification Playground Quick Start Guide .
Overview Realtime Document Verification provides:
Instant document verification results
Configurable validation rules
Detailed analysis and extraction
Low latency processing
Making a Request Endpoint POST https://demo.parcha.ai/api/v1/runFlashCheck Request Structure curl -X POST 'https://demo.parcha.ai/api/v1/runFlashCheck' \ -H 'Authorization: Bearer YOUR_API_KEY' \ -H 'Content-Type: application/json' \ -d '{ "agent_key": "doc-flash-v1", "check_id": "kyb.proof_of_address_verification", "check_args": { "validity_period": 90, "accepted_documents": ["utility_bill", "bank_statement"] }, "kyb_schema": { "id": "parcha-latest", "self_attested_data": { "business_name": "Parcha", "registered_business_name": "Parcha Labs Inc", "proof_of_address_documents": [ { "b64_document": "base64_encoded_document_content", "file_name": "utility_bill.pdf", "source_type": "file_url" } ] } } }'
Request Parameters The specific agent key for the Realtime Document Verification workflow. Currently supported: “doc-flash-v1”
The identifier for the specific check to run. Currently supported: “kyb.proof_of_address_verification”
Configuration options for the document verification
Maximum age of the document in days
List of acceptable document types
The KYB data schema containing business and document information
Schema version identifier. Use “parcha-latest” for the latest version.
The name of the business to validate
proof_of_address_documents
Array of document objects
Base64 encoded document content
Name of the document file
Source type of the document. Currently supported: “file_url”
Response Structure { "passed" : true , "answer" : "Valid bank statement; use as proof of address." , "agent_key" : "mercury-poa-v1" , "command_id" : "kyb.proof_of_address_verification" , "command_name" : "Proof of Address Check for Business" , "status" : "complete" , "payload" : { "type" : "ProofOfAddressFlashCheckResult" , "company_name" : "Parcha Labs, Inc." , "document_date" : "2025-01-01" , "document_type" : "BANK_STATEMENT" , "document_address" : { "type" : "Address" , "street_1" : "251 Little Falls Drive" , "street_2" : null , "city" : "Wilmington" , "state" : "Delaware" , "country_code" : "US" , "postal_code" : "19808" } }, "check_args" : { "validity_period" : 90 , "accepted_documents" : [ "Bank statement" , "VAT invoice" , "Utility bill" , "Signed tenancy or lease agreement" , "Tax document" , "Mortgage statement" , "Credit card statement" , "Home or renter's insurance policy" ] }, "input_data" : { "type" : "ProofOfAddressClassificationToolInput" , "document" : { "type" : "Document" , "url" : "https://storage.googleapis.com/parcha-ai-public-assets/parcha-labs%2C-inc._statement_2024.12.01-2025.01.01.pdf" , "file_name" : "Parcha_proof_of_address.pdf" , "source_type" : "file_url" } }, "command_instance_id" : "e3b93e50-0a4a-479e-afb3-4edbb698c190" , "created_at" : "2025-02-04T07:22:13.290674" , "updated_at" : "2025-02-04T07:22:16.492974" } Whether the document passed validation
Human-readable explanation of the validation result
The agent key used for processing
The identifier of the check that was run
Human-readable name of the check
Status of the check execution. Usually “complete” for Realtime Document Verifications
Extracted document information
Type identifier for the result payload
Business name found on document
Date found on document (YYYY-MM-DD format)
Address details extracted from document
Type identifier for the address object
Secondary street address (if any)
Arguments used for the check
Maximum age of document in days
List of document types that were accepted for validation
Information about the input document
Type identifier for the input data
Document details
Type identifier for the document object
URL to access the document
Name of the uploaded file
Source type of the document
Unique identifier for this check execution
Timestamp when the check was initiated
Timestamp when the check was completed
Use Cases Realtime Document Verification is ideal for:
Business document validation
Proof of address verification
Document information extraction
Real-time document screening
