Audit Log API

The audit log API lets your own systems read the audit log of a project or an agency — for archiving, periodic imports or your own reports. To have every new event pushed to you instead, use streaming; both deliver the same event format.

GET https://api.trustcomponent.com/platform/v1/events

Whether the API is available depends on your plan and add-ons; see Current add-ons.

1. Create an API key. In a project, open Settings › API Keys & Webhooks and choose Create API Key (Member role). In an agency, open Settings › API Keys (Auditor role).

2. Call the API with the key as bearer token:

   curl -H "Authorization: Bearer ak_..." \
     "https://api.trustcomponent.com/platform/v1/events?from=2026-09-01T00:00:00.000Z&to=2026-09-02T00:00:00.000Z&pageSize=100"

3. Read the next page by passing the nextCursor of the response as cursor, with the same from and to, until nextCursor is null.

A project key returns the events of the project and of all its modules. An agency key returns the events of the agency itself, not those of its client projects.

Events are sorted newest first. Read a range with the cursor: unlike page, it does not shift when new events arrive while you read. Events older than the audit retention of your plan are not returned.

{
  "from": "2026-09-01T00:00:00.000Z",
  "to": "2026-09-02T00:00:00.000Z",
  "content": [
    {
      "id": "cc2e2d5e-d1ef-4a7f-a7bd-dec5b37df47a",
      "schemaVersion": 2,
      "occurredAt": "2026-09-01T13:30:05.941Z",
      "type": "captcha.captcha.updated",
      "action": "updated",
      "subject": { "kind": "captcha.captcha", "id": "0f8e...", "label": "Checkout form" },
      "scopes": [{ "kind": "platform.subscription", "id": "5664...", "label": "Initech" }],
      "origin": { "namespace": "CAPTCHA", "source": "REST_CONTROLLER", "applicationName": "tc-captcha-captchaservice", "traceId": "a1b2...", "transactionId": "e5f6..." },
      "actor": { "type": "USER", "userId": "b1c2...", "apiKeyId": null, "automation": null },
      "changes": [{ "field": "label", "operation": "SET", "before": "Checkout", "after": "Checkout form", "isRedacted": false }],
      "details": {}
    }
  ],
  "page": 0,
  "pageSize": 100,
  "totalElements": 1,
  "nextCursor": null
}