# Retrieve a request

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

Operation ID: `requests.get` · API v3

Retrieves a logged API request together with the audit entries it produced.

`data.request` describes the request itself, and `data.effects` lists the resulting audit entries in ascending order of `occurred_at`.

Requests that do not exist or are not accessible with the current credentials return `404 Not Found` with the `not_found` error code.

Required permissions: `audit.read`.

## Parameters

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

## Responses

### 200

Returns the request and the audit entries it produced.

Body: `data`: object.

Fields of object:

| Field | Type | Required | Description |
|---|---|---|---|
| `effects` | array of AuditEntry | yes |  |
| `request` | RequestLog | yes | An authenticated API request. Every authenticated request is recorded, without sampling, and retained for 30 days. |

### 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 request was not found or is not accessible with the current credentials.

Body: Error.

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