# developers.requests.list

List recent API and MCP requests, newest first, with the request ID returned in X-Request-Id, the action, method, status, error code, duration and the key or app that sent it. Filter by status (ok, client_error, server_error), source (api, mcp), key, action or request ID. Kept for 30 days. Administrators see the whole company; everyone else sees their own requests.

`GET | POST /api/v1/accounting/developers.requests.list`

Permissions: `api_keys:manage` · Roles: admin, finance, contributor

MCP tool: `accounting_developers_requests_list`

## Fields

| Field | Type | Required | Notes |
| --- | --- | --- | --- |
| `status` | enum |  | Only include records with this status. One of: `ok`, `client_error`, `server_error`. |
| `source` | enum |  | Where the record came from. One of: `api`, `mcp`. |
| `credentialId` | string (ID) |  | The ID of the related record. |
| `action` | string |  | Matches ^[A-Za-z][A-Za-z0-9_.]{0,119}$. |
| `requestId` | string (ID) |  | The ID of the related record. |
| `days` | integer |  | 1 to 30. Default `30`. |
| `limit` | integer |  | How many results to return at most. 1 to 100. Default `25`. |
| `offset` | integer |  | How many results to skip, for the next page of a list. 0 to 10000. Default `0`. |

## Example request

```bash
curl https://app.getoatmilk.com/api/v1/accounting/developers.requests.list \
  -H "Authorization: Bearer $OATMILK_API_KEY"
```

Reference page: https://app.getoatmilk.com/docs/api/developers.requests.list