---
title: "Databricks ingestion run history (audit)"
method: GET
path: "/api/v1/databricks/sync-history"
tags: ["DATABRICKS", "Databricks", "Databricks Connections"]
---

# Databricks ingestion run history (audit)

`GET /api/v1/databricks/sync-history`

Paginated Databricks ingestion runs for the tenant, newest activity first.

Scoped to loader runs (``databricks_loader_*``) — the family this audit
categorizes. Tenant-wide, with no per-connection scoping: loader runs leave
``global_tasks.data_store_id`` null, so nothing attributes a loader run to
the connection that produced it and a ``data_store_id`` filter would match
zero rows. (Only ``databricks_extractor_*`` runs carry ``data_store_id``, and
then only recently; Last Sync in ``crud.sync`` uses those for attribution,
but they are a different run family and outside this loader-activity feed.)

``status`` is enum-typed so an unknown value is a 422 from FastAPI. Left as
free text it reaches Postgres as a cast to ``global_task_status_type`` and
comes back as an unexplained 500.

## Query parameters

- `status` GlobalTaskStatusType[] — Filter to these global_tasks statuses (e.g. completed, ingestion_failed).
- `category` 'system_tables' | 'cloud_cost' | 'lineage' — Which ingestion family a run belongs to, for grouping the audit table.
- `page` integer — Page number
- `size` integer — Page size

## Headers

- `x-tenant` string, required

## Response `200`

Successful Response

- PageDatabricksSyncRun
  - `items` DatabricksSyncRun[], required
    - `batch_id` integer, required
    - `dataset_type` string, required
    - `label` string, required
    - `category` 'system_tables' | 'cloud_cost' | 'lineage', required — Which ingestion family a run belongs to, for grouping the audit table.
    - `status` string, required
    - `deployment` string, nullable
    - `fetch_start_datetime` string, date-time, nullable
    - `fetch_end_datetime` string, date-time, nullable
    - `last_updated_on` string, date-time, nullable
  - `total` integer, nullable, required
  - `page` integer, nullable, required
  - `size` integer, nullable, required
  - `pages` integer, nullable

## Other responses

- `401` — Authentication required
- `403` — Not supported for public user
- `422` — Validation Error

## Changes

- **2026-09-02** `fcb62c79da95` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/myaltimate/apis/fastapi/changes/api/v1/databricks/sync-history/get.md)

---

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