Audit and Evaluations API

The Audit API provides read access to your full governance history for compliance reporting, custom analytics, and integrations with external audit and SIEM systems.

Base URL

https://amp.nomotic.ai/api/v1/audit

Export audit trail

GET /api/v1/audit/export

Returns a downloadable export of your audit trail. Query parameters:

from / to — date range (required for exports, maximum 90 days per request).

agent_id — filter to a specific agent.

verdict — filter by verdict type.

format — response format: json, csv, or cef (default: json).

For large exports, the response includes a download_url to a pre-signed URL valid for 15 minutes rather than returning the full payload inline.

Verify audit trail integrity

POST /api/v1/audit/verify

Request body:

json

{
  "from": "2026-01-01T00:00:00Z",
  "to": "2026-04-11T23:59:59Z"
}

Verifies the hash chain for the specified date range. Returns:

json

{
  "status": "valid",
  "records_verified": 48291,
  "from": "2026-01-01T00:00:00Z",
  "to": "2026-04-11T23:59:59Z",
  "verified_at": "2026-04-11T15:00:00Z"
}

If integrity is compromised, the response includes the ID and timestamp of the first record where the chain breaks.

Get evaluation statistics

GET /api/v1/audit/stats

Returns aggregated statistics for your organization. Query parameters:

period — day, week, month (default: month).

agent_id — scope to a specific agent.

Response includes verdict distribution, average UCS, escalation rate, evaluation volume, and governance coverage percentage.

Compliance report

GET /api/v1/audit/compliance-report

Returns a structured compliance report covering audit trail integrity, governance coverage, escalation resolution rate, and policy enforcement summary. Available in JSON and PDF format via the format parameter. Designed for EU AI Act Article 12 and SOC 2 reporting requirements.