Skip to main content

​
AIAX — Agent Interaction & eXchange

AIAX is Invoica’s machine-readable discovery surface. A compliant agent can start from a single URL (/.well-known/aiax.json) and — without any human configuration — discover what Invoica can do, what each capability costs, and how to call it. The design goal: an agent that has never seen Invoica before can issue its first invoice in under 60 seconds.

​
Three-tier structure

Agents start at Tier 0, fetch only the sections they need, and never have to read human docs.

​
Composition with PACT

AIAX sections wire directly into Invoica’s PACT mandate layer:
  • query_mandate section maps to GET /v1/public/mandates/:id — unauthenticated, redacted state + hashes
  • dispute_flow section maps to POST /v1/mandates/:id/dispute — requires API key, opens a dispute
An agent can verify a counterparty’s mandate state before paying an invoice, entirely through AIAX-described endpoints.

​
Three-step discovery

All static AIAX responses carry Cache-Control: public, max-age=300 and an ETag for efficient polling.

​
See Also