---
title: "List persisted build logs for an Xcode instance."
method: GET
path: "/v1/xcode_instances/{id}/build_logs"
---

# List persisted build logs for an Xcode instance.

`GET /v1/xcode_instances/{id}/build_logs`

Returns metadata and a short-lived presigned download URL for each
build that ran on the given Xcode instance. Builds are returned in
chronological order. Logs persist after the instance is terminated,
subject to the configured retention window.

## Path parameters

- `id` string, required

## Response `200`

OK

- XcodeBuildLog[]
  - `id` string, required — Exec ID assigned by limbuild, e.g. build-1776140344112378000.
  - `status` string, required — Terminal status reported by limbuild (e.g. SUCCEEDED, FAILED, CANCELLED).
  - `exitCode` integer — Exit code of xcodebuild, if the build reached completion.
  - `startedAt` string, date-time
  - `finishedAt` string, date-time
  - `buildDurationMs` integer — Time spent running xcodebuild, in milliseconds.
  - `error` string — Error message captured by limbuild on failure, if any.
  - `downloadUrl` string, required — Short-lived presigned URL for fetching the full .jsonl log from object storage.

## Other responses

- `default` — Error

---

[API](https://skmtc.net/limrun-inc/apis/limrun-api.md) · [All operations](https://skmtc.net/limrun-inc/apis/limrun-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/limrun-inc/limrun-api/versions/0a3cd7959546/schema)