---
title: "get commit log from ref. If both objects and prefixes are empty, return all commits."
method: GET
path: "/repositories/{repository}/refs/{ref}/commits"
tags: ["refs"]
---

# get commit log from ref. If both objects and prefixes are empty, return all commits.

`GET /repositories/{repository}/refs/{ref}/commits`

## Query parameters

- `after` string
- `amount` integer
- `objects` string[]
- `prefixes` string[]
- `limit` boolean
- `first_parent` boolean
- `since` string, date-time
- `stop_at` string

## Response `200`

commit log

- CommitList
  - `pagination` Pagination, required
    - `has_more` boolean, required — Next page is available
    - `next_offset` string, required — Token used to retrieve the next page
    - `results` integer, required — Number of values found in the results
    - `max_per_page` integer, required — Maximal number of entries per page
  - `results` Commit[], required
    - `id` string, required
    - `parents` string[], required
    - `committer` string, required
    - `message` string, required
    - `creation_date` integer, required — Unix Epoch in seconds
    - `meta_range_id` string, required
    - `metadata` object
    - `generation` integer
    - `version` integer

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Resource Not Found
- `429` — too many requests
- `default` — Internal Server Error

---

[API](https://skmtc.net/treeverse/apis/lakefs-api.md) · [All operations](https://skmtc.net/treeverse/apis/lakefs-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/treeverse/lakefs-api/revisions/4617f80bee61/schema)