Can I read an AI system's compliance status programmatically?
Yes. GET /api/compliance/dashboard returns the organisation-wide picture, /api/compliance/systems/{system_id} the detail for one system, and /api/risk-classification/{system_id}/latest the current classification with its citations, confidence score and unsupported claims. All return JSON and require a bearer token.
Everything the web app shows is available over the API, because the web app reads the same endpoints.
For monitoring or for an agent answering questions about your own estate, the useful ones are:
GET /api/ai-systems— the inventoryGET /api/risk-classification/{system_id}/latest— the current classification, including its citations, the verifier’s confidence score and any unsupported claimsGET /api/compliance/systems/{system_id}— per-system obligation statusGET /api/compliance/dashboard— the roll-up across systemsGET /api/compliance/urgent-actions— what is time-criticalGET /api/audit— the organisation’s audit log
The classification response is worth reading in full rather than reducing to a
tier string. verifier_confidence, unsupported_claims and the
requires-expert-review flag are the difference between “this system is
high-risk” and “this system is high-risk and we are confident about why” —
and an agent that drops those fields is discarding exactly the information
that makes the answer safe to act on.
Related API endpoints
/api/ai-systems bearer List AI systems for the organisation
/api/risk-classification/{system_id}/latest bearer Get the latest classification with citations and confidence
/api/compliance/dashboard bearer Get the organisation compliance dashboard
/api/audit bearer List audit log entries for the organisation
Base URL https://api.maditon.app ·
full specification at openapi.json
Read next
A free Solo account runs a real classification on one of your own systems — no card, no sales call.
Run a free classification