# Audit Log

Search the tenant's append-only audit log.

Generated from `apps/api/openapi.json`. HTML version: https://docs.institflow.com/en/reference/audit

1 operation.

## GET /api/v1/audit

List this tenant’s audit log entries (cursor-paginated).

- Operation id: `AuditController_list_v1`
- Permission: `audit.read`
- Auth: credential required
- `Idempotency-Key`: not required

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `cursor` | query | string | no |  |
| `limit` | query | integer | no | 1–100 · default: 25 |
| `action` | query | string | no | ≥1 chars |
| `entityType` | query | string | no | ≥1 chars |
| `entityId` | query | string (uuid) | no |  |
| `actorUserId` | query | string (uuid) | no |  |
| `from` | query | string (date-time) | no |  |
| `to` | query | string (date-time) | no |  |

### Responses

**200** — A page of audit log entries.

| Property | Type | Required | Constraints |
| --- | --- | --- | --- |
| `data` | array<object> | yes |  |
| `nextCursor` | string \| null | yes |  |

Every other status answers with the shared `ErrorEnvelope` — see
https://docs.institflow.com/md/en/error-codes.md

### Example request

```bash
curl -X GET "https://your-institute.example/api/v1/audit" \
  -H "Authorization: Bearer $INSTITFLOW_API_KEY"
```