---
title: "List commit authors"
method: GET
path: "/api/commits/authors"
tags: ["Git"]
---

# List commit authors

`GET /api/commits/authors`

Returns a paginated list of unique authors who committed in a repository, sorted by commit count descending. Optionally scoped to a file path.

## Query parameters

- `repo` string, required — The fully-qualified repository name.
- `ref` string — The git ref (branch, tag, or commit SHA) to list authors from. Defaults to `HEAD`.
- `path` string — Restrict authors to those who touched this file path.
- `page` integer
- `perPage` integer

## Response `200`

Paginated commit author list.

- PublicCommitAuthor[]
  - `name` string, required
  - `email` string, required
  - `commitCount` integer, required

## Other responses

- `400` — Invalid query parameters or git ref.
- `404` — Repository not found.
- `500` — Unexpected failure.

---

[API](https://skmtc.dev/sourcebot/apis/sourcebot-public-api.md) · [All operations](https://skmtc.dev/sourcebot/apis/sourcebot-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sourcebot/sourcebot-public-api/revisions/b0ed96fb7103/schema)