# List sandbox events

Collection: api
Human docs: https://zei.sh/docs/api

Read lifecycle events for a sandbox.

GET /public/sandboxes/:sandboxId/events?limit=100
Permission: MACHINE_READ.
Poll events to correlate asynchronous lifecycle transitions with an agent run.
Response: Events with status, source, timestamp, and optional message.

Example:

```
curl -X GET https://api.zei.sh/api/v1/public/sandboxes/:sandboxId/events?limit=100 \
  -H "X-API-Key: $ZEISH_API_KEY"
```