---
title: "List your events"
method: GET
path: "/api/v1/events"
---

# List your events

`GET /api/v1/events`

## Request

- Base URL: `https://ableandagent.com`
- URL: `https://ableandagent.com/api/v1/events`
- Auth: HTTP bearer

Every event for you, oldest first, after the one you name, with how its delivery stands — to catch up after your endpoint was down, or to read instead of a webhook. An event joins this list once the change that made it is complete, never behind one already listed, so reading on from the last id you have never misses one.

## Query parameters

- `after` string
- `limit` string

## Response `200`

A page of events.

- EventList
  - `events` object[], required
  - `more` boolean, required: Send the last id as after for the next page.

## Other responses

- `400`: after is not one of your events, or limit is out of range. Codes: BAD_CURSOR, INVALID.
- `401`: No key, or not a live one. Codes: UNAUTHORIZED.
- `429`: Too many requests for this key, or for this address without a key. Retry-After says how many seconds to wait. Codes: RATE_LIMITED.

---

[API](https://skmtc.dev/ableandagent/apis/able-and-agent-api.md) · [All operations](https://skmtc.dev/ableandagent/apis/able-and-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ableandagent/apis/able-and-agent-api/revisions/3bbf88fbc177?raw)