GET /v1/audit

Retrieve the event log for your organization. Events are written for every sign, verify, key creation, and key revocation.

Authentication required — Authorization: Bearer ctv_key_…

---

Request

GET /v1/audit?page=1&limit=20
Authorization: Bearer ctv_key_abc123

Query parameters

Parameter	Default	Max	Description
page	1	—	Page number (1-indexed)
limit	20	100	Events per page

---

Response

{
  "events": [
    {
      "event_id": "evt_uuid",
      "type": "sign",
      "timestamp": "2026-05-27T15:00:00.000Z",
      "metadata": {
        "record_id": "rec_uuid",
        "generator_id": "gen_abc123",
        "model": "stable-diffusion-xl"
      }
    }
  ],
  "total": 142,
  "page": 1,
  "limit": 20
}

Event types

Type	Trigger
sign	Provenance record submitted via POST /v1/records
verify	Content verified via POST /v1/verify
key_created	Generator registered
key_revoked	Generator revoked

---

Notes

• Events are scoped to your organization — you cannot see other orgs’ events
• Events are sorted newest-first
• Audit log access is included on all plans
• Export functionality (CSV/JSON bulk export) is available on Growth and above