List Audit Events

Beta

GET/v1/core/audit-events

This endpoint is idempotent. Learn more

Returns a paginated list of audit events for the current account.

cursoroptional string

Cursor token used to retrieve the next or previous page of results.

limitoptional integer

Maximum number of results per page (default: 100, max: 1000).

qoptional string

Search query used to filter results.

start_dateoptional string (date-time)

Restricts results to audit events on or after this timestamp.

end_dateoptional string (date-time)

Restricts results to audit events on or before this timestamp.

resource_types[]optional arrayenumValues:accountactorentity

Filter by the resource type of the audited entity.

resource_ids[]optional array

Filter by the audited resource IDs.

actor_ids[]optional array

Filter by the actor identifier.

Will be account_user.id when identity_type=user or an api_key.id when identity_type=api_key.

actions[]optional arrayenumValues:createupdatedelete

Filter by the audit actions.

include[]optional arrayenumValues:actorchangesmetadata

Sub-objects to expand in the response. When omitted, sub-objects are returned as null.

objectstringenumValues:list

Resource type identifier.

page_infoobject

Pagination metadata.

next_page_urlstringnullable

URL to fetch the next page, null if no more pages.

previous_page_urlstringnullable

URL to fetch the previous page, null if on the first page.

has_next_pageboolean

Whether more results exist after this page.

has_prev_pageboolean

Whether results exist before this page.

dataarray of object

Resources in this page.

idstring

Audit event ID.

objectstringenumValues:audit_event

Resource type identifier.

actionstringenumValues:createupdatedelete

Mutation type.

resource_typestringenumValues:accountactorentity

Resource type of the audited entity.

resource_idstring

Audited resource ID.

actorobjectExpandablenullable

Actor who performed the mutation.

idstring

Actor ID.

objectstringenumValues:actor

Resource type identifier.

typestringenumValues:userapi_keyagent

Actor type.

namestringnullable

Display name.

handlestringnullable

Human-readable handle (email for users, redacted_value for API keys, slug for agents).

roleobjectnullable

Assigned role.

Always returned as null in this endpoint.

changesobjectExpandablenullable

Field-level changes recorded for this event.

objectstringenumValues:list

Resource type identifier.

page_infoobject

Pagination metadata.

next_page_urlstringnullable

URL to fetch the next page, null if no more pages.

previous_page_urlstringnullable

URL to fetch the previous page, null if on the first page.

has_next_pageboolean

Whether more results exist after this page.

has_prev_pageboolean

Whether results exist before this page.

dataarray of object

Resources in this page.

objectstringenumValues:audit_field_change

Resource type identifier.

fieldstring

Name of the changed field.

old_valueobjectnullable

Previous value as a JSON fragment. Null for creation events. Encoded as a JSON value (object, array, string, number, boolean, or null), not a JSON-encoded string.

new_valueobjectnullable

New value as a JSON fragment. Null for deletion events. Encoded as a JSON value (object, array, string, number, boolean, or null), not a JSON-encoded string.

metadataobjectExpandablenullable

Arbitrary JSON metadata for the mutation (e.g. reason, source, tags). Encoded as a JSON value (object, array, string, number, boolean, or null), not a JSON-encoded string.

requestobjectExpandablenullable

Originating HTTP request. Expandable.

idstring

Request log ID.

objectstringenumValues:request_log

Resource type identifier.

methodstring

HTTP method.

hoststring

Request host. Usually api.augno.com.

pathstring

Non-normalized request path.

normalized_routestring

Normalized route template. For example PATCH /v1/sales/customers/{id} is the normalized route for a request route PUT /v1/sales/customers/ac_....

query_paramsobjectnullable

Query parameters. Encoded as a JSON value (object, array, string, number, boolean, or null), not a JSON-encoded string.

status_codeinteger

HTTP status code.

latency_usinteger

Request latency in microseconds.

api_versionstringnullable

API version used.

client_ipstringnullable

Client IP address.

user_agentstringnullable

User agent.

referrerstringnullable

Referrer header.

error_codestringnullable

API error code.

error_messagestringnullable

Error message.

occurred_atstring (date-time)

When the request occurred.

created_atstring (date-time)

When the log entry was created.

accountobjectnullable

Account targeted by the request.

Always returned as null in this endpoint.

actorobjectnullable

Actor who made the request.

Always returned as null in this endpoint.

idempotency_keystringnullable

User-provided idempotency key.

request_bodyobjectnullable

Request body. Encoded as a JSON value (object, array, string, number, boolean, or null), not a JSON-encoded string.

response_bodyobjectnullable

Response body. Encoded as a JSON value (object, array, string, number, boolean, or null), not a JSON-encoded string.

idempotency_keystringnullable

Idempotency key of the originating request.

source_ipstringnullable

Originating client IP address.

occurred_atstring (date-time)

When the audited mutation occurred.

created_atstring (date-time)

When the audit event record was created.

Responses

200

Successful response for List Audit Events

List Audit Events

import Augno from '@augno/sdk';

const client = new Augno({
  bearerToken: 'YOUR_API_KEY', // Your API key goes here
});

const listAuditEvent = await client.core.auditEvents.list();

console.log(listAuditEvent.data);

import Augno from '@augno/sdk';

const client = new Augno({
  bearerToken: 'YOUR_API_KEY', // Your API key goes here
});

const listAuditEvent = await client.core.auditEvents.list();

console.log(listAuditEvent.data);

200 example

{
  "object": "list",
  "page_info": {
    "next_page_url": "/v1/core/audit-events?cursor=eyJjIjoiMjAyNi0wNS0xMFQwMDowMDowMFoiLCJzIjoiYWVfMDFiMWMwN2RjMzA4NWJiZDg0MTExZWRjYmQiLCJkIjoiZiJ9.rB4tbzdSkwlW82H0aa7OcOo3XZSC6naG3tNOKf_4Qyc",
    "previous_page_url": null,
    "has_next_page": true,
    "has_prev_page": false
  },
  "data": [
    {
      "id": "ae_01b1c07dc3085bbd84111edcbd",
      "object": "audit_event",
      "action": "update",
      "resource_type": "user",
      "resource_id": "us_0151164dcaea4cbded27b50aae",
      "actor": {
        "id": "us_0151164dcaea4cbded27b50aae",
        "object": "actor",
        "type": "user",
        "name": "John Doe",
        "handle": "jdoe@augno.com",
        "role": null
      },
      "changes": {
        "object": "list",
        "page_info": {
          "has_next_page": false,
          "has_prev_page": false
        },
        "data": [
          {
            "object": "audit_field_change",
            "field": "email",
            "old_value": [
              34,
              111,
              108,
              100,
              64,
              101,
              120,
              97,
              109,
              112,
              108,
              101,
              46,
              99,
              111,
              109,
              34
            ],
            "new_value": [
              34,
              110,
              101,
              119,
              64,
              101,
              120,
              97,
              109,
              112,
              108,
              101,
              46,
              99,
              111,
              109,
              34
            ]
          }
        ]
      },
      "metadata": [
        123,
        34,
        114,
        101,
        97,
        115,
        111,
        110,
        34,
        58,
        34,
        111,
        112,
        101,
        114,
        97,
        116,
        111,
        114,
        32,
        111,
        118,
        101,
        114,
        114,
        105,
        100,
        101,
        34,
        125
      ],
      "request": {
        "id": "rq_01304bffe90e8cce9690cbefd4",
        "object": "request_log",
        "status_code": 0,
        "latency_us": 0
      },
      "source_ip": "198.51.100.8",
      "occurred_at": "2026-05-10T00:00:00Z",
      "created_at": "2026-05-10T00:00:00Z"
    }
  ]
}

{
  "object": "list",
  "page_info": {
    "next_page_url": "/v1/core/audit-events?cursor=eyJjIjoiMjAyNi0wNS0xMFQwMDowMDowMFoiLCJzIjoiYWVfMDFiMWMwN2RjMzA4NWJiZDg0MTExZWRjYmQiLCJkIjoiZiJ9.rB4tbzdSkwlW82H0aa7OcOo3XZSC6naG3tNOKf_4Qyc",
    "previous_page_url": null,
    "has_next_page": true,
    "has_prev_page": false
  },
  "data": [
    {
      "id": "ae_01b1c07dc3085bbd84111edcbd",
      "object": "audit_event",
      "action": "update",
      "resource_type": "user",
      "resource_id": "us_0151164dcaea4cbded27b50aae",
      "actor": {
        "id": "us_0151164dcaea4cbded27b50aae",
        "object": "actor",
        "type": "user",
        "name": "John Doe",
        "handle": "jdoe@augno.com",
        "role": null
      },
      "changes": {
        "object": "list",
        "page_info": {
          "has_next_page": false,
          "has_prev_page": false
        },
        "data": [
          {
            "object": "audit_field_change",
            "field": "email",
            "old_value": [
              34,
              111,
              108,
              100,
              64,
              101,
              120,
              97,
              109,
              112,
              108,
              101,
              46,
              99,
              111,
              109,
              34
            ],
            "new_value": [
              34,
              110,
              101,
              119,
              64,
              101,
              120,
              97,
              109,
              112,
              108,
              101,
              46,
              99,
              111,
              109,
              34
            ]
          }
        ]
      },
      "metadata": [
        123,
        34,
        114,
        101,
        97,
        115,
        111,
        110,
        34,
        58,
        34,
        111,
        112,
        101,
        114,
        97,
        116,
        111,
        114,
        32,
        111,
        118,
        101,
        114,
        114,
        105,
        100,
        101,
        34,
        125
      ],
      "request": {
        "id": "rq_01304bffe90e8cce9690cbefd4",
        "object": "request_log",
        "status_code": 0,
        "latency_us": 0
      },
      "source_ip": "198.51.100.8",
      "occurred_at": "2026-05-10T00:00:00Z",
      "created_at": "2026-05-10T00:00:00Z"
    }
  ]
}

List Audit Events

Query Parameters

Returns

Responses