---
title: "Fetch a sandbox by id"
method: GET
path: "/sandbox-templates/{templateId}"
tags: ["sandbox-templates"]
---

# Fetch a sandbox by id

`GET /sandbox-templates/{templateId}`

## Request

- Base URL: `https://api.letsship.ai/v1`
- URL: `https://api.letsship.ai/v1/sandbox-templates/{templateId}`
- Auth: none declared

## Path parameters

- `templateId` string, required

## Response `200`

Sandbox

- SandboxTemplate
  - `id` string, required
  - `orgId` string, required
  - `name` string, required
  - `kind` 'org' | 'repo', required: `org`: defined in the console or API. `repo`: defined by a project's `.ship/sandbox.Dockerfile`; read-only here, edited in the repository.
  - `projectId` string, nullable, required
  - `starterId` string, nullable, required
  - `dockerfile` string, required
  - `size` union, required
    - 'lite' | 'basic' | 'standard-1' | 'standard-2' | 'standard-3' | 'standard-4'
    - object
      - `vcpu` integer, required
      - `memoryMib` integer, required
      - `diskMb` integer, required
  - `instanceType` 'lite' | 'basic' | 'standard-1' | 'standard-2' | 'standard-3' | 'standard-4', required
  - `activeVersionId` string, nullable, required
  - `activeVersion` integer, nullable, required
  - `latestBuild` SandboxTemplateBuildSummary, required
    - `id` string, required
    - `status` 'queued' | 'building' | 'ready' | 'failed', required
    - `phase` 'validate' | 'run-steps' | 'snapshot' | 'warm', required
    - `finishedAt` string, nullable, required
  - `runningCount` integer, required
  - `createdAt` integer, required
  - `updatedAt` integer, required

## Other responses

- `404`: Not found

---

[API](https://skmtc.dev/letsship/apis/ship-api.md) · [All operations](https://skmtc.dev/letsship/apis/ship-api/llms.txt) · [OpenAPI document](https://skmtc.dev/letsship/apis/ship-api/revisions/e6eac1bcadd4?raw)