---
title: "List events"
description: "Trillet OEM API: The event log, newest first."
openapi: /public/openapi/trillet-oem.yaml GET /partner/v1/events
lastUpdated: "2026-10-28"
---

> **For AI agents:** the complete documentation index is at [llms.txt](https://docs.trillet.ai/llms.txt). Append `.md` to any page URL for its markdown version.

`GET https://api.trillet.ai/partner/v1/events`

The event log, newest first. Events are kept for 30 days, and an event is recorded when at
least one of your endpoints subscribes to its type. In the list, `data` holds only the facts
stored with the event. Needs `events:read`.

## Authentication

- `partnerKey` — http bearer (tpk_live_...)

## Query parameters

- `type` (string)
- `tenantId` (string)
- `since` (integer) — Only events created at or after this time, in Unix seconds.
- `limit` (integer)
- `starting_after` (string) — The `id` of the last event on the previous page.

## Response 200

A page of events.
  - response (object)
    - `object` (string, required)
    - `data` (array, required)
      - `items` (object)
        - `object` (string, required)
        - `id` (string, required)
        - `type` (string, required)
        - `tenantId` (string | null)
        - `data` (object, required)
        - `created` (integer, required) — Unix seconds.
        - `deliveries` (array, required)
          - `items` (object)
            - endpointId: … (nested further)
            - status: … (nested further)
            - attempts: … (nested further)
            - lastAttemptAt: … (nested further)
            - lastStatusCode: … (nested further)
            - lastError: … (nested further)
    - `hasMore` (boolean, required)

## Response 400

The request is malformed or a field is invalid. `error.param` names the field when there is one.
  - response (object)
    - `error` (object, required)
      - `type` (string, required, one of: invalid_request_error, authentication_error, permission_error, conflict_error, rate_limit_error, api_error, idempotency_error)
      - `code` (string, required) — A stable code. Handle errors by `code`, not by `message`.
      - `message` (string, required)
      - `param` (string) — The request field the error is about, when there is one.
      - `requestId` (string | null) — Include it when you contact support. Not present on idempotency errors.

## Response 401

The partner key is missing, malformed, unknown or revoked (`partner_key_required`, `invalid_api_key`, `partner_not_enabled`).
  - response (object)
    - `error` (object, required)
      - `type` (string, required, one of: invalid_request_error, authentication_error, permission_error, conflict_error, rate_limit_error, api_error, idempotency_error)
      - `code` (string, required) — A stable code. Handle errors by `code`, not by `message`.
      - `message` (string, required)
      - `param` (string) — The request field the error is about, when there is one.
      - `requestId` (string | null) — Include it when you contact support. Not present on idempotency errors.

## Response 403

`missing_scope`, or `key_restricted` on webhook endpoint routes.
  - response (object)
    - `error` (object, required)
      - `type` (string, required, one of: invalid_request_error, authentication_error, permission_error, conflict_error, rate_limit_error, api_error, idempotency_error)
      - `code` (string, required) — A stable code. Handle errors by `code`, not by `message`.
      - `message` (string, required)
      - `param` (string) — The request field the error is about, when there is one.
      - `requestId` (string | null) — Include it when you contact support. Not present on idempotency errors.

## Response 404

`event_not_found` when `starting_after` is not one of your events.
  - response (object)
    - `error` (object, required)
      - `type` (string, required, one of: invalid_request_error, authentication_error, permission_error, conflict_error, rate_limit_error, api_error, idempotency_error)
      - `code` (string, required) — A stable code. Handle errors by `code`, not by `message`.
      - `message` (string, required)
      - `param` (string) — The request field the error is about, when there is one.
      - `requestId` (string | null) — Include it when you contact support. Not present on idempotency errors.


---

📦 **OpenAPI specs:** Every OpenAPI specification referenced by this documentation is available as a single download — https://docs.trillet.ai/api-specs.zip