> ## Documentation Index
> Fetch the complete documentation index at: https://wordsmithai.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# List events

> List the events you can read from the last 30 days, oldest first.

The event log holds the same events webhook endpoints receive, for 30 days. Use it to catch up after your receiver was down. Each event is checked as you: you see only events whose resource you can read and whose scope your credential grants. Filters apply after the read, so a page can hold fewer than `limit` events and still have a `cursor`.

## Authentication

Requires an API key, or an OAuth token with `webhooks:read`. With `audience=customer`, also `webhooks:admin`.

## Query parameters

**types** `string`

Comma-separated event types to return. A wildcard such as `task.*` is allowed.

**created\_after** `string`

ISO 8601. Without a cursor, start at events created at or after this time.

**audience** `string` (default: user)

`customer` lists events about work shared with the whole organisation.

**cursor** `string`

The `cursor` from the previous page.

**limit** `integer` (default: 50)

Events per page, from 1 to 100.

## Response

Returns a page of events. A `cursor` of `null` means you have read to the end of the log.

```bash cURL theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl "https://api.wordsmith.ai/api/v1/events?types=task.*,review.completed&created_after=2026-11-08T00:00:00Z" \
  -H "Authorization: Bearer sk-ws-api1-your_api_key_here"
```

```json Response theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "items": [
    {
      "id": "8d2f4a61-3c7e-4b09-a5d1-9e6f0b2c7a48",
      "type": "task.assigned",
      "api_version": "2026-11-01",
      "created_at": "2026-11-09T10:12:03Z",
      "resource": {
        "type": "task",
        "id": "5f0c9a12-8e3b-4d71-a6c4-0b2e9f7d3c58"
      },
      "actor": {
        "kind": "user",
        "id": "1a2b3c4d-5e6f-4a70-8b91-c2d3e4f5a6b7"
      },
      "data": {
        "task_id": "5f0c9a12-8e3b-4d71-a6c4-0b2e9f7d3c58",
        "status": "open",
        "assignee_id": "9c1d2e3f-4a5b-4c6d-8e7f-0a1b2c3d4e5f",
        "team_id": null,
        "agent_id": null,
        "url": "https://app.wordsmith.ai/tasks?activeId=5f0c9a12-8e3b-4d71-a6c4-0b2e9f7d3c58"
      }
    }
  ],
  "cursor": null
}
```

## Errors

| Status | `error_code` | When |
| - | - | - |
| 400 | `bad_request` | A `created_after` that is not ISO 8601, or a `cursor` this API did not return. |
| 403 | `insufficient_scope` | `audience=customer` without `webhooks:admin`. |
| 404 | `resource_not_found` | Webhooks are not on for your organisation. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.