---
title: "GET /ace/{ace_uid}/jobs/{job_uid}"
method: GET
path: "/ace/{ace_uid}/jobs/{job_uid}"
tags: ["ace"]
---

# GET /ace/{ace_uid}/jobs/{job_uid}

`GET /ace/{ace_uid}/jobs/{job_uid}`

## Request

- Base URL: `https://api.timbal.ai`
- URL: `https://api.timbal.ai/ace/{ace_uid}/jobs/{job_uid}`
- Auth: HTTP bearer

Get a single ACE job by id.

## Path parameters

- `ace_uid` string, uuid, required
- `job_uid` string, uuid, required

## Response `200`

Job

- AceJobView: Public view of a background job against an ACE.
  - `completed_at` string, date-time, nullable
  - `duration_ms` integer, nullable
  - `error_message` string, nullable: Present when the job terminated unsuccessfully (`failed`, `error`, `cancelled`).
  - `iteration_count` integer, required
  - `kind` string, required
  - `queued_at` string, date-time, required
  - `started_at` string, date-time, nullable
  - `status` string, required
  - `tool_call_count` integer, required
  - `uid` string, uuid, required

## Other responses

- `403`: Forbidden
- `404`: Job or ACE not found

## Changes

- **2026-04-24** `f24cc7de524c`: 1 info
  - endpoint added
- **2026-03-16** `eb2c08128881`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/timbal-ai/apis/timbal-platform-api/changes/ace/:ace_uid/jobs/:job_uid/get.md)

---

[API](https://skmtc.dev/timbal-ai/apis/timbal-platform-api.md) - [All operations](https://skmtc.dev/timbal-ai/apis/timbal-platform-api/llms.txt) - [OpenAPI document](https://skmtc.dev/timbal-ai/apis/timbal-platform-api/revisions/dd7e398ce0d3?raw)