Identra Docs
Reference / Audit

List audit history (newest first, paginated, filterable) for the resolved application.

GET /v1/audit-logs
Secret API key operationId: list

Authorization

Server-to-server. Send a secret key as a Bearer token plus the x-application-id header.

Query parameters

  • type string optional

    Exact type (`session.revoked`) or a dotted family by prefix (`session` → all `session.*`).

  • actor_kind string optional

    Actor kind: `user | api_key | system | public`.

  • aggregate_id string<uuid> optional

    Restrict to events touching one aggregate (a user/session/org id).

  • search string optional

    Free-text match on the event type.

  • after string<date-time> optional

    Inclusive lower/upper bounds on when the event occurred (RFC 3339).

  • before string<date-time> optional
  • limit integer<int64> optional

    Page size (default 50, max 100).

  • offset integer<int64> optional

    Row offset (default 0).

Responses

200 Audit history
{
  "data": {
    "limit": 0,
    "logs": [
      {
        "actor": null,
        "aggregate_id": null,
        "entry_hash": null,
        "event_id": null,
        "id": null,
        "occurred_at": null,
        "payload": null,
        "prev_hash": null,
        "recorded_at": null,
        "type": null,
        "version": null
      }
    ],
    "offset": 0,
    "total": 0
  },
  "error": {
    "code": "string",
    "message": "string"
  },
  "meta": {
    "timestamp": "string"
  },
  "success": false
}

Request

curl -X GET "http://localhost:8080/v1/audit-logs" \

Try it

live request
GET http://localhost:8080/v1/audit-logs

Query parameters