---
title: "Template build status"
method: GET
path: "/templates/{templateID}/builds/{buildID}/status"
tags: ["templates"]
---

# Template build status

`GET /templates/{templateID}/builds/{buildID}/status`

Get template build info

## Path parameters

- `templateID` string, required
- `buildID` string, required

## Query parameters

- `logsOffset` integer
- `limit` integer
- `level` 'debug' | 'info' | 'warn' | 'error' — State of the sandbox

## Response `200`

Successfully returned the template

- TemplateBuildInfo
  - `logs` string[], required — Build logs
  - `logEntries` BuildLogEntry[], required — Build logs structured
    - `timestamp` string, date-time, required — Timestamp of the log entry
    - `message` string, required — Log message content
    - `level` 'debug' | 'info' | 'warn' | 'error', required — State of the sandbox
    - `step` string — Step in the build process related to the log entry
  - `templateID` string, required — Identifier of the template
  - `buildID` string, required — Identifier of the build
  - `status` 'building' | 'waiting' | 'ready' | 'error', required — Status of the template build
  - `reason` BuildStatusReason
    - `message` string, required — Message with the status reason, currently reporting only for error status
    - `step` string — Step that failed
    - `logEntries` BuildLogEntry[] — Log entries related to the status reason
      - `timestamp` string, date-time, required — Timestamp of the log entry
      - `message` string, required — Log message content
      - `level` 'debug' | 'info' | 'warn' | 'error', required — State of the sandbox
      - `step` string — Step in the build process related to the log entry

## Other responses

- `401` — Authentication error
- `404` — Not found
- `500` — Server error

## Changes

> 53 revisions in range; 4 could not be searched.

- **2026-07-24** `93ed246a4c10` — 2 info
  - the endpoint scheme security `AdminApiKeyAuth AND AdminTeamAuth` was added to the API
  - the endpoint scheme security `Supabase1TokenAuth AND Supabase2TeamAuth` was removed from the API
- **2026-05-27** `e13ef89d456c` — 1 info
  - the endpoint scheme security `AuthProviderBearerAuth AND AuthProviderTeamAuth` was added to the API
- **2026-01-27** `05ac348d449f` — 2 info
  - the endpoint scheme security `Supabase1TokenAuth AND Supabase2TeamAuth` was added to the API
  - the endpoint scheme security `Supabase1TokenAuth` was removed from the API
- **2026-01-12** `83a3cddc628f` — 1 info
  - added the new optional `query` request parameter `limit`
- **2025-10-31** `8ee0d0d1e95e` — 2 info
  - added the optional property `logEntries/items/step` to the response with the `200` status
  - added the optional property `reason/logEntries` to the response with the `200` status

[Full history](https://skmtc.dev/e2b-dev/apis/e2b-api/changes/templates/:templateID/builds/:buildID/status/get.md)

---

[API](https://skmtc.dev/e2b-dev/apis/e2b-api.md) · [All operations](https://skmtc.dev/e2b-dev/apis/e2b-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/e2b-dev/e2b-api/revisions/e01b3f5506fe/schema)