---
title: "List unbackfilled Delta table commits. WARNING: This API is experimental and may change in future versions."
method: GET
path: "/delta/preview/commits"
tags: ["DeltaCommits"]
---

# List unbackfilled Delta table commits. WARNING: This API is experimental and may change in future versions.

`GET /delta/preview/commits`

## Request

- Base URL: `http://localhost:8080/api/2.1/unity-catalog`
- URL: `http://localhost:8080/api/2.1/unity-catalog/delta/preview/commits`
- Auth: none declared

List all the unbackfilled Delta commits that are currently being tracked by the UC coordinator.
If no commits are being tracked in the specific version range (from start_version to an optional end_version),
it will return an empty list.
WARNING: This API is experimental and may change in future versions.

## Request body

- DeltaGetCommits
  - `table_id` string, required: The ID of the table to get the commits for. This ID uniquely identifies a table.
  - `table_uri` string, required: The URI of the storage location of the table. If the table_id exists but the table_uri is different from the one previously registered (e.g., if the client moved the table), the request will fail. Example: s3://bucket-name/tables/some-table-id
  - `start_version` integer, required: The start version from which to retrieve commits (inclusive). This along with the optional end_version specifies the range of commit versions that this request wants.
  - `end_version` integer: The end version upto which to retrieve commits (inclusive). If not set, the latest version will be used as the end version. This does not affect the latest_table_version in the response. If num of commits that meet this criteria is larger than a limit set by server config, the response will be limited to the first X commits. Call can send request again with a larger start_version according to the response to get the remaining commits.

## Response `200`

Successful response

- DeltaGetCommitsResponse
  - `commits` DeltaCommitInfo[], required: The list of unbackfilled Delta table commits. Can be in arbitrary order.
    - `version` integer, required: The version of this commit.
    - `timestamp` integer, required: The timestamp for when the commit was made. This is the in-commit timestamp as produced by the Delta client writing to the table.
    - `file_name` string, required: The filename of the UUID-based commit file.
    - `file_size` integer, required: The size of the commit file in bytes.
    - `file_modification_timestamp` integer, required: The modification time of the commit file. This is the mod time of the file as written to the file system.
  - `latest_table_version` integer, required: Represents the latest version of the table tracked by UC. For a newly created managed table with no commits, this returns 0. Use this field to manage pagination — if the returned commits don't cover the range up to latest_table_version or end_version (whichever is smaller), it indicates that more unbackfilled commits may be available.

## Other responses

- `400`: Bad request or Invalid Argument. Example: table_uri in the request doesn't match the existing table_uri for the table.
- `401`: Unauthorized. Authentication credentials are missing or incorrect.
- `403`: Forbidden. The user does not have the necessary permissions to perform this action.
- `404`: Not Found. The specified table does not exist.
- `500`: Internal Server Error. An unexpected error occurred on the server.

## Changes

- **2025-11-18** `6bf5d456fce0`: 2 info
  - the response property `commits` became required for the status `200`
  - the response property `latest_table_version` became required for the status `200`
- **2025-11-13** `9bf8ea0ab2f4`: 4 warning, 3 info
  - deleted the `query` request parameter `end_version`
  - deleted the `query` request parameter `start_version`
  - deleted the `query` request parameter `table_id`
  - deleted the `query` request parameter `table_uri`
  - …3 more
- **2025-11-07** `70b8941c5703`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/unitycatalog/apis/unity-catalog-api/changes/delta/preview/commits/get.md)

---

[API](https://skmtc.dev/unitycatalog/apis/unity-catalog-api.md) - [All operations](https://skmtc.dev/unitycatalog/apis/unity-catalog-api/llms.txt) - [OpenAPI document](https://skmtc.dev/unitycatalog/apis/unity-catalog-api/revisions/c84507f0d7e0?raw)