# List requests

`GET https://api.cademi.com.br/api/v3/requests`

Operation ID: `requests.list` · API v3

Lists the authenticated API requests made on the current account, most recent first by default.

Results are paginated with a cursor. The collection can be filtered by outcome, action code, affected resource (`resource_type` and `resource_id`), and time range (`occurred_after` and `occurred_before`).

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 |  |
| `outcome[]` | query | array of string | no |  |
| `action_code` | query | string | no |  |
| `resource_type` | query | string | no |  |
| `resource_id` | query | string | no |  |
| `occurred_after` | query | string (date-time) | no |  |
| `occurred_before` | query | string (date-time) | no |  |

## Responses

### 200

Returns a page of requests.

Body: `data`: array of RequestLog.

Fields of RequestLog:

| Field | Type | Required | Description |
|---|---|---|---|
| `action` | string | yes | operationId of the called operation. |
| `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 | Request ID (ULID), identical to the X-Request-Id response header. |
| `item_key` | string or null | no |  |
| `kind` | string, one of `request` | yes |  |
| `method` | string or null | no |  |
| `object` | string, one of `request_log` | 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`, `read` | 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