# List History

> `GET /history` · History

Canonical page: https://clawifi.dev/docs/api/get-history

`GET https://api.clawifi.dev/history`

The account's own operations, newest first. Filters: kind, status, the API key that ran it (`api_key_id`),

- Send your key as `Authorization: Bearer $CLAWIFI_API_KEY`; see [Authentication](https://clawifi.dev/docs/authentication).
- Hosted MCP tool: `list_history` on `https://api.clawifi.dev/mcp`.
- Credits: see [Pricing and credits](https://clawifi.dev/docs/pricing-and-credits).

## Request

**cURL**

```sh
curl https://api.clawifi.dev/history \
  -H "Authorization: Bearer $CLAWIFI_API_KEY"
```

**Python**

```python
from clawifi import Clawifi

client = Clawifi()  # reads CLAWIFI_API_KEY
result = client.list_history()
```

**MCP**

```text
list_history()
```

### Parameters

| Name | In | Type | Required |
| --- | --- | --- | --- |
| `limit` | query | integer | no |
| `cursor` | query | string (optional) | no |
| `kind` | query | OperationKind (optional) | no |
| `status` | query | OperationStatus (optional) | no |
| `created_after` | query | string (optional) | no |
| `created_before` | query | string (optional) | no |
| `api_key_id` | query | string (optional) | no |
| `operation` | query | string (optional) | no |

## Response

200 with a JSON object.

Errors use the shared shape; see [Errors](https://clawifi.dev/docs/errors). Try public operations without a key in the [playground](https://clawifi.dev/playground).