> ## Documentation Index
> Fetch the complete documentation index at: https://e2b.manicule.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For every page in one file, fetch https://e2b.manicule.dev/llms-full.txt (large).
> To search and read these docs as tools, connect the MCP server at https://e2b.manicule.dev/api/mcp.
> Every agent surface: https://e2b.manicule.dev/.well-known/llms-manifest.json

# Monitor sandbox lifecycle events (/docs/sandbox/lifecycle-events-api)

<!-- agent-signals: reading_time_min: 3 · est_tokens: 1438 · updated: 2026-07-30 -->
Related: [Auto-resume on request](/docs/sandbox/auto-resume.md), [Connect to running sandbox](/docs/sandbox/connect.md), [Environment variables](/docs/sandbox/environment-variables.md), [Filesystem-only snapshots](/docs/sandbox/filesystem-only-snapshots.md), [Sandbox forking](/docs/sandbox/fork.md), [Git integration](/docs/sandbox/git-integration.md)

The lifecycle API provides RESTful endpoints to request the latest sandbox lifecycle events. This allows you to track when sandboxes are created, paused, resumed, updated, snapshotted, or killed, along with metadata.
All requests require authentication using your project [API key](/docs/api-key#where-to-find-api-key).

## Retention

Sandbox lifecycle events are retained for **7 days** by default. After the retention window passes, a sandbox's events are no longer available through this API.

Query Parameters:

* `offset` (optional): Number of events to skip (default: 0, min: 0)
* `limit` (optional): Number of events to return (default: 10, min: 1, max: 100)
* `orderAsc` (optional): Sort order - true for ascending, false for descending (default: false)
* `types` (optional): Filter by event type. Can be specified multiple times to match any of the given types.

<CodeGroup>
```js title="JavaScript & TypeScript"
import { Sandbox } from 'e2b'

const sbx = await Sandbox.create()

// Get the latest events for a specific sandbox
const resp1 = await fetch(
  `https://api.e2b.app/events/sandboxes/${sbx.id}`,
  {
    method: 'GET',
    headers: {
      'X-API-Key': E2B_API_KEY,
    },
  }
)
const sandboxEvents = await resp1.json()

// Get the latest 10 events for all sandboxes associated with the project
const resp2 = await fetch(
  'https://api.e2b.app/events/sandboxes?limit=10',
  {
    method: 'GET',
    headers: {
      'X-API-Key': E2B_API_KEY,
    },
  }
)
const teamSandboxEvents = await resp2.json()

// Filter events by type
const resp3 = await fetch(
  'https://api.e2b.app/events/sandboxes?types=sandbox.lifecycle.created&types=sandbox.lifecycle.killed',
  {
    method: 'GET',
    headers: {
      'X-API-Key': E2B_API_KEY,
    },
  }
)
const filteredEvents = await resp3.json()

console.log(teamSandboxEvents)

// [
//   {
//     "version": "v1",
//     "id": "f5911677-cb60-498f-afed-f68143b3cc59",
//     "type": "sandbox.lifecycle.killed",
//     "eventData": null,
//     "sandboxBuildId": "a979a14b-bdcc-49e6-bc04-1189fc9fe7c2",
//     "sandboxExecutionId": "1dae9e1c-9957-4ce7-a236-a99d5779aadf",
//     "sandboxId": "${SANDBOX_ID}",
//     "sandboxTeamId": "460355b3-4f64-48f9-9a16-4442817f79f5",
//     "sandboxTemplateId": "rki5dems9wqfm4r03t7g",
//     "timestamp": "2025-08-06T20:59:36Z"
//   },
//   {
//     "version": "v1",
//     "id": "30b09e11-9ba2-42db-9cf6-d21f0f43a234",
//     "type": "sandbox.lifecycle.updated",
//     "eventData": {
//       "set_timeout": "2025-08-06T20:59:59Z"
//     },
//     "sandboxBuildId": "a979a14b-bdcc-49e6-bc04-1189fc9fe7c2",
//     "sandboxExecutionId": "1dae9e1c-9957-4ce7-a236-a99d5779aadf",
//     "sandboxId": "${SANDBOX_ID}",
//     "sandboxTeamId": "460355b3-4f64-48f9-9a16-4442817f79f5",
//     "sandboxTemplateId": "rki5dems9wqfm4r03t7g",
//     "timestamp": "2025-08-06T20:59:29Z"
//   },
//   [...]
//   {
//     "version": "v1",
//     "id": "0568572b-a2ac-4e5f-85fa-fae90905f556",
//     "type": "sandbox.lifecycle.created",
//     "eventData": null,
//     "sandboxBuildId": "a979a14b-bdcc-49e6-bc04-1189fc9fe7c2",
//     "sandboxExecutionId": "1dae9e1c-9957-4ce7-a236-a99d5779aadf",
//     "sandboxId": "${SANDBOX_ID}",
//     "sandboxTeamId": "460355b3-4f64-48f9-9a16-4442817f79f5",
//     "sandboxTemplateId": "rki5dems9wqfm4r03t7g",
//     "timestamp": "2025-08-06T20:59:24Z"
//   }
// ]
```

```python title="Python"
import requests
from e2b import Sandbox

sbx = Sandbox.create()

# Get the latest events for a specific sandbox
resp1 = requests.get(
    f"https://api.e2b.app/events/sandboxes/{sbx.sandbox_id}",
    headers={
        "X-API-Key": E2B_API_KEY,
    }
)
sandbox_events = resp1.json()

# Get the latest 10 events for all sandboxes associated with the project
resp2 = requests.get(
    "https://api.e2b.app/events/sandboxes?limit=10",
    headers={
        "X-API-Key": E2B_API_KEY,
    }
)
team_sandbox_events = resp2.json()

# Filter events by type
resp3 = requests.get(
    "https://api.e2b.app/events/sandboxes",
    params={"types": ["sandbox.lifecycle.created", "sandbox.lifecycle.killed"]},
    headers={
        "X-API-Key": E2B_API_KEY,
    }
)
filtered_events = resp3.json()

print(team_sandbox_events)

# [
#   {
#     "version": "v1",
#     "id": "0568572b-a2ac-4e5f-85fa-fae90905f556",
#     "type": "sandbox.lifecycle.killed",
#     "eventData": null,
#     "sandboxBuildId": "a979a14b-bdcc-49e6-bc04-1189fc9fe7c2",
#     "sandboxExecutionId": "1dae9e1c-9957-4ce7-a236-a99d5779aadf",
#     "sandboxId": "${SANDBOX_ID}",
#     "sandboxTeamId": "460355b3-4f64-48f9-9a16-4442817f79f5",
#     "sandboxTemplateId": "rki5dems9wqfm4r03t7g",
#     "timestamp": "2025-08-06T20:59:36Z"
#   },
#   {
#     "version": "v1",
#     "id": "e7013704-2c51-4dd2-9f6c-388c91460149",
#     "type": "sandbox.lifecycle.updated",
#     "eventData": {
#       "set_timeout": "2025-08-06T20:59:59Z"
#     },
#     "sandboxBuildId": "a979a14b-bdcc-49e6-bc04-1189fc9fe7c2",
#     "sandboxExecutionId": "1dae9e1c-9957-4ce7-a236-a99d5779aadf",
#     "sandboxId": "${SANDBOX_ID}",
#     "sandboxTeamId": "460355b3-4f64-48f9-9a16-4442817f79f5",
#     "sandboxTemplateId": "rki5dems9wqfm4r03t7g",
#     "timestamp": "2025-08-06T20:59:29Z"
#   },
#   [...]
#   {
#     "version": "v1",
#     "id": "f29ef778-2743-4c97-a802-7ba67f84ce24",
#     "type": "sandbox.lifecycle.created",
#     "eventData": null,
#     "sandboxBuildId": "a979a14b-bdcc-49e6-bc04-1189fc9fe7c2",
#     "sandboxExecutionId": "1dae9e1c-9957-4ce7-a236-a99d5779aadf",
#     "sandboxId": "${SANDBOX_ID}",
#     "sandboxTeamId": "460355b3-4f64-48f9-9a16-4442817f79f5",
#     "sandboxTemplateId": "rki5dems9wqfm4r03t7g",
#     "timestamp": "2025-08-06T20:59:24Z"
#   }
# ]
```
</CodeGroup>