> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gravixlayer.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get a Snapshot

> Look up a snapshot by ID or name

`GET /v1/agents/snapshots/{id_or_name}`

Use the snapshot UUID or its project-unique name.

<CodeGroup>
  ```python Python theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
  from gravixlayer import GravixLayer

  client = GravixLayer()  # defaults to cloud="aws", region="us-east-1"

  snap = client.snapshots.get("after-warmup")
  print(snap.id, snap.kind, snap.state, snap.region)
  ```

  ```typescript TypeScript theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
  import { GravixLayer } from 'gravixlayer';

  const client = new GravixLayer(); // defaults to cloud="aws", region="us-east-1"

  const snap = await client.snapshots.get("after-warmup");
  console.log(snap.id, snap.kind, snap.state, snap.region);
  ```

  ```bash CLI theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
  gravixlayer snapshot get after-warmup
  gravixlayer snapshot get "$SNAPSHOT_ID" --output json
  ```

  ```bash cURL theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
  # Requires: GRAVIXLAYER_API_KEY
  API="https://api.gravixlayer.ai/v1"

  curl -sS "$API/agents/snapshots/after-warmup" \
    -H "Authorization: Bearer $GRAVIXLAYER_API_KEY"
  ```
</CodeGroup>

## Response

Returns a [snapshot object](/documentation/agentruntime/snapshots/overview#snapshot-object).

`last_used_at` updates when you successfully create a sandbox from the snapshot.