BY NUMBER7 AIaccepted
Request authenticated and idempotency reserved.
DEVELOPERS
Ship transaction intelligence.
Keep your product yours.
One API for document-family assembly, typed financial claims, evidence, controls, resolution state and downstream outcome verification.
POST /api/v1/upload
?document.type=invoice&document.version=v1
multipart: file + fileName + fileType
EVENT job.completed
{ "jobId": "job_example",
"fileStatus": "done" }UPLOADSTATEWEBHOOK
Illustrative workflow · sample data, not a performance guarantee.
QUICK START
Create a transaction job.
Upload the document family once. Observe its lifecycle through canonical state and signed events.
Read the quick start →POST /api/v1/upload
Authorization: Bearer $TOKEN
Idempotency-Key: txn_8471
{ document_type: invoice_family, client_id: entity_42 }
202 ACCEPTED
{ jobId: job_7f92, state: assembling }01 / LIFECYCLE
Async is a product contract, not an implementation detail.
Processing, resolution and execution can span systems and people.
202
assembling
Pages classified and document family reconstructed.
controlling
Claims grounded; financial controls executing.
needs_action
Typed exception with evidence and permitted actions.
ready
Required controls and authority satisfied.
executed
Downstream outcome reconciled to canonical state.
02 / RESULT OBJECT
Return reasons, not only values.
Build interfaces and automations that can explain the transaction.
Typed claims
Headers, lines, references, confidence and normalization.
Evidence objects
Document, page, region and extracted source.
Control results
Rule, input, outcome, consequence and version.
Exception state
Cause, owner, SLA and permitted resolution.
Execution state
Intended action, downstream ID and verification.
Supersession
What changed, when and why.
03 / RELIABILITY
Designed for production failure modes.
- Idempotency
- Stable keys across safe ingestion and export retries.
- Signed webhooks
- Raw-body verification, event IDs and replay-safe handling.
- Error classes
- Transport, schema, document and transaction failures stay distinct.
- Tenant isolation
- Credentials and context are scoped to the environment and client.
- Versioning
- Additive evolution, pinned contracts and migration windows.
04 / BUILD VS BUY
Own the differentiated workflow, not the hidden control burden.
AIdaptIQ replaces the recurring engineering surface beneath reliable finance automation.
Boundary models
Combined files and document-family reconstruction.
Financial schemas
Typed claims across invoice, PO, GRN and credit note.
Evidence lineage
Persistent locators and assertion history.
Control framework
Arithmetic, identity, duplicate, policy and match state.
Resolution lifecycle
Human action as typed transaction state.
Evaluation harness
Frozen populations, metrics and silent-error sampling.
ARCHITECTURE REVIEW
Bring the workflow contract.
We will map request lifecycle, evidence requirements, failure handling and downstream ownership.