# Retrieve an audit entry

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

Operation ID: `audit_entries.get` · API v3

Retrieves an audit entry by its public ID, which uses the `aud_` prefix (for example, `aud_42`).

Malformed IDs and entries that do not exist or are not accessible with the current credentials return `404 Not Found`.

Required permissions: `audit.read`.

## Parameters

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `audit_entry_id` | path | string | yes |  |

## Responses

### 200

Returns the requested audit entry.

Body: `data`: 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 |  |

### 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.

### 404

The audit entry was not found or is not accessible with the current credentials.

Body: Error.

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