---
title: "List an instance's events"
method: GET
path: "/sandboxes/{sandbox_id}/events"
tags: ["Sandboxes"]
---

# List an instance's events

`GET /sandboxes/{sandbox_id}/events`

## Request

- Base URL: `https://api.hedra.com/v3`
- URL: `https://api.hedra.com/v3/sandboxes/{sandbox_id}/events`
- Auth: one of:
  - API key in header `Authorization`
  - HTTP bearer

The lifecycle events of one instance.

## Path parameters

- `sandbox_id` string, required: The sandbox's id (`sandbox_<uuid>`).

## Query parameters

- `replica` integer: The instance's replica number, from 0.

## Response `200`

Successful Response

- SandboxEventListResponse
  - `data` SandboxEvent[], required: The instance's events.
    - `at` string, date-time, required
    - `kind` 'created' | 'draining' | 'stopping', required: The hedra-compute event kinds the events route publishes.
    - `message` string, required: What happened, for a person to read.
  - `next_cursor` string, nullable, required: Opaque cursor for the next page, or null when this response completes the list. Always present. Endpoints that serve the whole collection at once always return null.

## Other responses

- `400`: Invalid or failed-validation request.
- `401`: Authentication failed: missing, malformed, or invalid credentials.
- `403`: Insufficient scope or plan.
- `404`: Resource not found.
- `429`: Rate limit exceeded.
- `500`: Internal error.
- `503`: Sandboxes are temporarily unavailable, or are still being set up for your workspace; retry shortly.

## Changes

- **2026-10-23** `e733493214f4`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/hedra-labs/apis/hedra-api/changes/sandboxes/:sandbox_id/events/get.md)

---

[API](https://skmtc.dev/hedra-labs/apis/hedra-api.md) - [All operations](https://skmtc.dev/hedra-labs/apis/hedra-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hedra-labs/apis/hedra-api/revisions/6ef35a11cefe?raw)