REST API v1Bearer token auth

Audit API Reference

The Audit API provides programmatic access to your governance event log. Use it to build compliance dashboards, feed audit data into your SIEM, or generate SOC 2 review packages.

Authentication

All requests require a bearer token in the Authorization header:

Authorization: Bearer ifp_live_xxxx...

GET /audit/runs

List governance events with pagination and filtering.

Request
GET /v1/audit/runs?model_id=credit-risk-v3&limit=50&after=2026-01-01

# Query parameters:
# model_id     string   Filter by model identifier
# event_type   string   drift.detected | retrain.approved | model.promoted
# limit        int      Max results per page (1-200, default 50)
# after        date     ISO 8601 date, events after this date
# before       date     ISO 8601 date, events before this date
# cursor       string   Pagination cursor from previous response
Response 200
{
  "data": [
    {
      "id": "evt_3kXn2c",
      "event_type": "retrain.approved",
      "model_id": "credit-risk-v3",
      "actor": "[email protected]",
      "actor_role": "ml-lead",
      "policy_version": "[email protected]",
      "timestamp": "2026-04-15T08:23:11Z",
      "metadata": { "psi": 0.12 }
    }
  ],
  "next_cursor": "eyJpZCI6Im...",
  "has_more": true
}

GET /audit/runs/{id}

Retrieve the full detail record for a single audit event, including the complete policy snapshot and all metadata fields.

GET /audit/export

Export audit log as CSV or JSON for offline analysis or SOC 2 evidence packages.

GET /v1/audit/export?format=csv&after=2026-01-01&before=2026-04-01

# format: csv | json | jsonl (JSON Lines)
# Returns 200 with Content-Disposition: attachment header