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

<!-- agent-signals: reading_time_min: 3 · est_tokens: 1782 · 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 [#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>
  <CodeBlockTabs defaultValue="JavaScript & TypeScript" groupId="javascript-typescript+python">
    <CodeBlockTabsList>
      <CodeBlockTabsTrigger value="JavaScript & TypeScript">
        JavaScript & TypeScript
      </CodeBlockTabsTrigger>

      <CodeBlockTabsTrigger value="Python">
        Python
      </CodeBlockTabsTrigger>
    </CodeBlockTabsList>

    <CodeBlockTab value="JavaScript & TypeScript">
      ```js  
      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"
      //   }
      // ]
      ```
    </CodeBlockTab>

    <CodeBlockTab value="Python">
      ```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"
      #   }
      # ]
      ```
    </CodeBlockTab>
  </CodeBlockTabs>
</CodeGroup>