Prefiler operates as a stateless backend compliance validation server. Integrating systems can query Discovery endpoints or post structured ledgers and evidence to fetch reproducible verification reports.
Factual Note: The payloads, rule IDs, and version numbers displayed below are representative, synthetic examples for B2B integration modeling. They do not constitute actual deployed facts.
Integrators query this headless endpoint to retrieve supported jurisdictions, pack versions, validation statuses, and required files dynamically.
{
"action": "discover",
"engine_version": "standalone-analysis-engine/v2",
"supported_jurisdictions": {
"IN": {
"name": "India",
"pack_version": "example-only",
"validation_status": "validated",
"categories": [
{ "id": "general", "label": "General Ledger Assessment" }
],
"required_evidence": [
{ "id": "bank_statement", "label": "Bank Statement" }
]
}
}
}Submit raw general ledger lists alongside supplementary files, period contexts, and bank records.
{
"jurisdiction": "IN",
"period": "FY_2025_26",
"entity": {
"external_id": "entity_demo_001"
},
"ledger": {
"source": "host_erp",
"records": []
},
"evidence": {
"bank_records": [],
"tax_records": []
}
}Returns the completed evaluation. Findings index arithmetic variances, rules evaluated, and validation states.
{
"analysis_id": "analysis_demo_001",
"status": "completed",
"jurisdiction": "IN",
"jurisdiction_pack_version": "example-only",
"calculation_mode": "deterministic",
"findings": [
{
"finding_id": "finding_demo_001",
"category": "gross_receipts_variance",
"severity": "high",
"expected_amount": 12676910,
"observed_amount": 12482410,
"variance": 194500,
"rules_evaluated": [
"IN-REC-EXAMPLE",
"IN-TDS-EXAMPLE"
],
"evidence_references": [],
"requires_professional_review": true
}
]
}Requests are authenticated via static secure Bearer tokens mapped per client organization, passed in request headers.
Prevent duplicate transactions by passing optional client-generated X-Idempotency-Key headers on start calls.
For large files, Prefiler provides an asynchronous job status pattern. Poll the job status endpoint at /api/v1/jobs/:id.
Calculations are rule-based, deterministic, and pinned to selected filing years, guaranteeing reproducible audits.
Trace calculated outputs back to coordinates inside bank statements or general ledger records for proof validation.
If a required statement or form is absent, Prefiler returns a structured error payload detailing the missing inputs.
Invalid schemas or incomplete datasets are rejected with explicit, readable bad-request diagnostics before rule execution.
Prefiler operates strictly in-memory. Volatile raw file buffers are immediately flushed from RAM post-processing.
Contact our technical team to schedule a walkthrough, request API schema specifications, or review private dedicated deployment options.