---
title: "Get job runs"
method: GET
path: "/api/v1/databricks/jobs/{job_id}/runs"
tags: ["DATABRICKS", "Databricks", "Databricks Jobs"]
---

# Get job runs

`GET /api/v1/databricks/jobs/{job_id}/runs`

Get runs for a specific job.

## Path parameters

- `job_id` string, required

## Query parameters

- `start_date` string, date, required — Start date
- `end_date` string, date — End date
- `result_state` string[], nullable — Filter by result state. Repeat the query param to pass multiple values (e.g. ?result_state=FAILED&result_state=TIMED_OUT). Valid values: SUCCEEDED, FAILED, SKIPPED, CANCELLED, TIMED_OUT, ERROR, BLOCKED.
- `run_ids` string[], nullable — Filter by specific run IDs
- `trigger_types` string[], nullable — Filter by trigger types
- `sortAttribute` string, nullable — Sort column name. Valid columns: run_id, start_time, duration_seconds, trigger_type, result_state, cost_cents.
- `sortOrder` string, nullable — Sort direction: 'asc' or '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

- JobRunsResponse — Response for job runs.
  - `job_id` string, required
  - `runs` JobRun[], required
    - `run_id` string, required
    - `job_id` string, required
    - `workspace_id` string, required
    - `instance_id` integer, nullable
    - `run_name` string, nullable
    - `result_state` string, nullable
    - `start_time` string, date-time, required
    - `end_time` string, date-time, nullable
    - `duration_seconds` number, nullable
    - `trigger_type` string, nullable
    - `trigger_display` string, nullable
    - `run_type` string, nullable
    - `cost_cents` number, nullable
  - `total_count` integer, required
  - `page` integer
  - `page_size` integer
  - `total_pages` integer

## Other responses

- `403` — Not authorized
- `404` — No ClickHouse database configured
- `422` — Validation Error

---

[API](https://skmtc.net/myaltimate/apis/fastapi.md) · [All operations](https://skmtc.net/myaltimate/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/myaltimate/fastapi/revisions/a9773752575f/schema)