---
title: "List Usage Events"
method: GET
path: "/v1/workspaces/{workspace}/usage/events"
tags: ["v1", "protected", "usage"]
---

# List Usage Events

`GET /v1/workspaces/{workspace}/usage/events`

Return newest persisted facts first, scoped to the current workspace.

## Path parameters

- `workspace` string, required — Slug of the workspace the request acts in

## Query parameters

- `source` string, nullable
- `kind` string, nullable
- `resource_kind` string, nullable
- `resource_id` string, nullable
- `task_id` string, nullable
- `from` string, nullable
- `until` string, nullable
- `cursor` string, nullable
- `limit` integer

## Response `200`

Successful Response

- UsageEventListResponse
  - `events` UsageEventResponse[], required
    - `data_json` string, required
    - `id` string, required
    - `incarnation_id` string, required
    - `kind` string, required
    - `occurred_at` string, required
    - `received_at` string, required
    - `resource_id` string, required
    - `resource_kind` string, required
    - `schema_version` integer, required
    - `sequence` string, required
    - `source` string, required
    - `task_id` string, required
    - `workspace_id` string, required
  - `next_cursor` string, nullable, required

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-26** `d3ad8e1a3681` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/agentarea/apis/agentarea-api/changes/v1/workspaces/:workspace/usage/events/get.md)

---

[API](https://skmtc.dev/agentarea/apis/agentarea-api.md) · [All operations](https://skmtc.dev/agentarea/apis/agentarea-api/llms.txt) · [OpenAPI document](https://skmtc.dev/agentarea/apis/agentarea-api/revisions/c926881f6c6e?raw)