The Flash Check 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.

​
Overview

Flash Check 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

​
Request Parameters

​
agent_key
string
required

The specific agent key for the Flash Check workflow. Currently supported: “doc-flash-v1”

​
check_id
string
required

The identifier for the specific check to run. Currently supported: “kyb.proof_of_address_verification”

​
check_args
object
required

Configuration options for the document verification

​
kyb_schema
object
required

The KYB data schema containing business and document information

​
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"
}
​
passed
boolean

Whether the document passed validation

​
answer
string

Human-readable explanation of the validation result

​
agent_key
string

The agent key used for processing

​
command_id
string

The identifier of the check that was run

​
command_name
string

Human-readable name of the check

​
status
string

Status of the check execution. Usually “complete” for Flash Checks

​
payload
object

Extracted document information

​
check_args
object

Arguments used for the check

​
input_data
object

Information about the input document

​
command_instance_id
string

Unique identifier for this check execution

​
created_at
string

Timestamp when the check was initiated

​
updated_at
string

Timestamp when the check was completed

​
Use Cases

Flash Check is ideal for:

  • Business document validation
  • Proof of address verification
  • Document information extraction
  • Real-time document screening
Getting Started with Parcha APIStart KYB Agent Job