Reference
API Reference
The full OpenAPI specification is served by the backend at GET /openapi.json.
Payment endpoints
| Method | Path | Auth | Description |
|---|---|---|---|
| GET | /api/health | none | Liveness probe |
| GET | /api/demo | none | Free demo endpoint |
| POST | /api/payment/challenge | none | Issue an x402 quote |
| POST | /api/payment/verify | none | Verify a proof against a quote |
| GET | /api/payment/status/{quote_id} | none | Read state-machine state |
| POST | /api/premium-query | x402 | Agent Kit-backed premium query |
| POST | /api/compliance/check | x402 | Legacy compliance check |
| POST | /api/compliance/certify/{quote_id} | x402 | Legacy full report |
| GET | /api/compliance/report/{report_id} | none | Legacy report fetch |
| GET | /api/receipt/{tx_id} | none | Read the HCS receipt |
Audit endpoints (new)
| Method | Path | Auth | Description |
|---|---|---|---|
| POST | /api/audit/submit | none | Submit a service for audit (returns payment quote) |
| POST | /api/audit/run/{quote_id} | paid | Run live probes + static analysis + LLM review |
| GET | /api/audit/report/{report_id} | none | Fetch audit report JSON |
| GET | /api/audit/report/{report_id}/pdf | none | Download PDF report |
| GET | /api/audit/report/{report_id}/skill.md | none | AI-agent SKILL.md |
| GET | /api/audit/certificate/{certificate_id} | none | Fetch soulbound certificate |
| GET | /api/audit/certificates | none | List all certificates (newest first) |