# List agent events

`GET /v1/projects/{project}/agents/{agent}/events`, operation `agents.ListAgentEvents`

Lists the events of an agent's transcript, oldest first, or newest first.

## Parameters

| Name | In | Required | Type | Description |
| --- | --- | --- | --- | --- |
| `project` | path | Yes | `string` | The project's ID. |
| `agent` | path | Yes | `string` | The agent's ID. |
| `pageSize` | query | No | `integer (int32)` | Maximum number of events to return. Defaults to 50; values above 500 are treated as 500. A page holds fewer once its events reach 2 MiB, which files can. |
| `pageToken` | query | No | `string` | Page token from a previous response, with the same orderBy. |
| `orderBy` | query | No | `string` | sequence, the default, lists the oldest events first; sequence desc lists the newest first, as a reader opening a long transcript wants. |

## Responses

### 200

OK

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `events` | `AgentEvent[]` | Yes | Events, in the order asked: oldest first by default. |
| `nextPageToken` | `string` | Yes | Token for the next page; empty on the last page. |

### default

Error

Base URL: `https://api.kosem.ai`. See [API conventions](https://docs.kosem.ai/reference/api-conventions.md) for authentication, pagination and errors, and [https://docs.kosem.ai/openapi.yaml](https://docs.kosem.ai/openapi.yaml) for the full OpenAPI document.