# List audit entries

`GET https://api.cademi.com.br/api/v3/audit-entries`

Operation ID: `audit_entries.list` · API v3

Lists the audit entries of the current account: write operations, denied or rejected requests, background effects, and management actions. Successful read requests are not included; they are available through the Requests endpoints.

Results are paginated by cursor and sorted by `occurred_at`, newest first by default. The collection can be filtered by kind, outcome, action code, resource, request ID, and occurrence time range.

Requires the `audit.read` permission for the account.

Required permissions: `audit.read`.

## Parameters

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `limit` | query | integer | no |  |
| `cursor` | query | string | no |  |
| `sort` | query | string, one of `occurred_at`, `-occurred_at` | no |  |
| `kind[]` | query | array of string | no |  |
| `outcome[]` | query | array of string | no |  |
| `action_code` | query | string | no |  |
| `resource_type` | query | string | no |  |
| `resource_id` | query | string | no |  |
| `request_id` | query | string | no |  |
| `occurred_after` | query | string (date-time) | no |  |
| `occurred_before` | query | string (date-time) | no |  |

## Responses

### 200

Returns a page of audit entries.

Body: `data`: array of AuditEntry.

Fields of AuditEntry:

| Field | Type | Required | Description |
|---|---|---|---|
| `action` | string | yes |  |
| `actor` | object | no |  |
| `client_request_id` | string or null | no |  |
| `credential` | object or null | no |  |
| `diff` | object or null | no |  |
| `event_id` | string or null | no |  |
| `http_status` | integer or null | no |  |
| `id` | string | yes |  |
| `item_key` | string or null | no |  |
| `kind` | string, one of `request`, `effect`, `management` | yes |  |
| `method` | string or null | no |  |
| `object` | string, one of `audit_entry` | yes |  |
| `occurred_at` | string (date-time) | yes |  |
| `operation_id` | string or null | no |  |
| `origin` | object | no |  |
| `outcome` | string, one of `succeeded`, `accepted`, `failed`, `denied`, `rejected`, `replayed` | yes |  |
| `path` | string or null | no |  |
| `recorded_at` | string (date-time) | yes |  |
| `request_id` | string | yes |  |
| `resource` | object or null | no |  |

### 400

The cursor is invalid, or the request contains an unsupported query parameter.

Body: Error.

### 401

The credential is missing, malformed, expired, or revoked.

Body: Error.

### 403

The current credentials do not have the permission required by this operation.

Body: Error.

### 422

The request body or query parameters failed validation.

Body: ValidationFailed.

Full schema: https://cademi.dev/openapi/v3.json