# Get build status (/docs/api-reference/templates/get-build-status)

<!-- agent-signals: reading_time_min: 3 · est_tokens: 1841 · updated: 2026-07-30 -->
Related: [Create template (v3)](/docs/api-reference/templates/create-template-v3.md), [List templates (v2)](/docs/api-reference/templates/list-templates-v2.md), [Create template (v2)](/docs/api-reference/templates/create-template-v2.md), [Get build upload link](/docs/api-reference/templates/get-build-upload-link.md), [List templates](/docs/api-reference/templates/list-templates.md), [Create template](/docs/api-reference/templates/create-template.md)

# Get build status

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

Get template build info

## OpenAPI

```json
{
  "security": [
    {
      "AccessTokenAuth": []
    },
    {
      "ApiKeyAuth": []
    }
  ],
  "parameters": [
    {
      "name": "templateID",
      "in": "path",
      "required": true,
      "schema": {
        "type": "string"
      }
    },
    {
      "name": "buildID",
      "in": "path",
      "required": true,
      "schema": {
        "type": "string"
      }
    },
    {
      "in": "query",
      "name": "logsOffset",
      "schema": {
        "default": 0,
        "type": "integer",
        "format": "int32",
        "minimum": 0
      },
      "description": "Index of the starting build log that should be returned with the template"
    },
    {
      "in": "query",
      "name": "limit",
      "schema": {
        "default": 100,
        "type": "integer",
        "format": "int32",
        "minimum": 0,
        "maximum": 100
      },
      "description": "Maximum number of logs that should be returned"
    },
    {
      "in": "query",
      "name": "level",
      "schema": {
        "type": "string",
        "description": "Severity level for log entries (e.g. info, warn, error)"
      }
    }
  ],
  "responses": {
    "200": {
      "description": "Successfully returned the template",
      "content": {
        "application/json": {
          "schema": {
            "required": [
              "templateID",
              "buildID",
              "status",
              "logs",
              "logEntries"
            ],
            "properties": {
              "logs": {
                "default": [],
                "description": "Build logs",
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "logEntries": {
                "default": [],
                "description": "Build logs structured",
                "type": "array",
                "items": {
                  "required": [
                    "timestamp",
                    "message",
                    "level"
                  ],
                  "properties": {
                    "timestamp": {
                      "type": "string",
                      "format": "date-time",
                      "description": "Timestamp of the log entry"
                    },
                    "message": {
                      "type": "string",
                      "description": "Log message content"
                    },
                    "level": {
                      "type": "string",
                      "description": "Severity level for log entries (e.g. info, warn, error)"
                    },
                    "step": {
                      "type": "string",
                      "description": "Step in the build process related to the log entry"
                    }
                  },
                  "type": "object"
                }
              },
              "templateID": {
                "type": "string",
                "description": "Identifier of the template"
              },
              "buildID": {
                "type": "string",
                "description": "Identifier of the build"
              },
              "status": {
                "type": "string",
                "description": "Status of the template build",
                "enum": [
                  "building",
                  "waiting",
                  "ready",
                  "error",
                  "uploaded"
                ]
              },
              "reason": {
                "required": [
                  "message"
                ],
                "properties": {
                  "message": {
                    "type": "string",
                    "description": "Message with the status reason, currently reporting only for error status"
                  },
                  "step": {
                    "type": "string",
                    "description": "Step that failed"
                  },
                  "logEntries": {
                    "default": [],
                    "description": "Log entries related to the status reason",
                    "type": "array",
                    "items": {
                      "required": [
                        "timestamp",
                        "message",
                        "level"
                      ],
                      "properties": {
                        "timestamp": {
                          "type": "string",
                          "format": "date-time",
                          "description": "Timestamp of the log entry"
                        },
                        "message": {
                          "type": "string",
                          "description": "Log message content"
                        },
                        "level": {
                          "type": "string",
                          "description": "Severity level for log entries (e.g. info, warn, error)"
                        },
                        "step": {
                          "type": "string",
                          "description": "Step in the build process related to the log entry"
                        }
                      },
                      "type": "object"
                    }
                  }
                },
                "type": "object"
              }
            },
            "type": "object"
          }
        }
      }
    },
    "401": {
      "description": "Authentication error",
      "content": {
        "application/json": {
          "schema": {
            "required": [
              "code",
              "message"
            ],
            "properties": {
              "code": {
                "type": "integer",
                "format": "int32",
                "description": "Error code"
              },
              "message": {
                "type": "string",
                "description": "Error"
              }
            },
            "type": "object"
          }
        }
      }
    },
    "404": {
      "description": "Not found",
      "content": {
        "application/json": {
          "schema": {
            "required": [
              "code",
              "message"
            ],
            "properties": {
              "code": {
                "type": "integer",
                "format": "int32",
                "description": "Error code"
              },
              "message": {
                "type": "string",
                "description": "Error"
              }
            },
            "type": "object"
          }
        }
      }
    },
    "500": {
      "description": "Server error",
      "content": {
        "application/json": {
          "schema": {
            "required": [
              "code",
              "message"
            ],
            "properties": {
              "code": {
                "type": "integer",
                "format": "int32",
                "description": "Error code"
              },
              "message": {
                "type": "string",
                "description": "Error"
              }
            },
            "type": "object"
          }
        }
      }
    }
  }
}
```