---
title: "Get run/task-scoped task runs (requires run_id or task_key)"
method: GET
path: "/api/v1/databricks/jobs/{job_id}/task-runs/detail"
tags: ["DATABRICKS", "Databricks", "Databricks Jobs"]
---

# Get run/task-scoped task runs (requires run_id or task_key)

`GET /api/v1/databricks/jobs/{job_id}/task-runs/detail`

## Request

- Base URL: `https://api.myaltimate.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.myaltimate.com/api/v1/databricks/jobs/{job_id}/task-runs/detail`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Run/task-scoped task runs: one row per ``(task_key, job_run_id)``.

Requires ``run_id`` (the tasks of a specific run) or ``task_key`` (one
task's runs over time).

## Path parameters

- `job_id` string, required

## Query parameters

- `start_date` string, date, required: Start date
- `end_date` string, date: End date
- `run_id` string, nullable: Filter by specific run ID
- `task_key` string, nullable: Filter by specific task key
- `sortAttribute` string, nullable: Column name to sort by. Valid columns: task_key, result_state, start_time, total_duration_seconds, cost_cents.
- `sortOrder` string, nullable: Sort direction: 'asc' or 'desc' (defaults to 'desc').
- `page` integer: Page number (1-indexed)
- `page_size` integer: Items per page
- `navigationSource` string, nullable

## Headers

- `x-tenant` string, required

## Response `200`

Successful Response

- JobTaskRunsResponse: Response for job task runs.
  - `job_id` string, required
  - `task_runs` JobTaskRun[], required
    - `task_key` string, required
    - `job_run_id` string, required
    - `task_run_id` string, nullable
    - `result_state` string, nullable
    - `start_time` string, date-time, nullable
    - `end_time` string, date-time, nullable
    - `total_duration_seconds` number, nullable
    - `run_count` integer, nullable
    - `cost_cents` number, nullable
    - `cluster_name` string, nullable
    - `cluster_id` string, nullable
  - `total_count` integer, required
  - `page` integer
  - `page_size` integer
  - `total_pages` integer

## Other responses

- `400`: run_id or task_key required
- `403`: Not authorized
- `404`: No ClickHouse database configured
- `422`: Validation Error

---

[API](https://skmtc.dev/myaltimate/apis/fastapi.md) - [All operations](https://skmtc.dev/myaltimate/apis/fastapi/llms.txt) - [OpenAPI document](https://skmtc.dev/myaltimate/apis/fastapi/revisions/e0c123b49501?raw)