---
title: "List events"
method: GET
path: "/v1/events"
tags: ["Events"]
---

# List events

`GET /v1/events`

List events for the authenticated account, ordered by sequence.

## Query parameters

- `starting_after` string
- `limit` integer
- `action` string
- `target` string
- `target_type` string
- `since` integer
- `until` integer

## Response `200`

Paginated list of events.

- MarketApiListEventsResponse
  - `object` 'list', required
  - `data` MarketApiEventResponse[], required
    - `object` 'event', required
    - `id` string, required
    - `cursor` string, required
    - `action` string, required
    - `occurred_at` integer, required
    - `actor` union, required — API-facing actor type that redacts internal system identifiers.
      - object
        - `id` string, required
        - `type` 'token', required
      - object
        - `type` 'system', required
    - `targets` MarketApiTarget[], required
      - `type` string, required
      - `id` string, required
    - `context` MarketApiContext, required
      - `workspace` string, nullable
      - `zone` string, nullable
  - `has_more` boolean, required
  - `cursor` string

## Other responses

- `400` — Validation failed.
- `401` — Unauthorized.
- `403` — Forbidden.
- `410` — Cursor references a deleted event.
- `500` — Internal server error.

---

[API](https://skmtc.net/sfcompute/apis/san-francisco-compute-documentation.md) · [All operations](https://skmtc.net/sfcompute/apis/san-francisco-compute-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sfcompute/san-francisco-compute-documentation/revisions/93dd7661e9bb/schema)