---
title: "Commit list"
method: GET
path: "/{service}/{owner_username}/repos/{repo_name}/commits/"
tags: ["Commits"]
---

# Commit list

`GET /{service}/{owner_username}/repos/{repo_name}/commits/`

Returns a paginated list of commits for the specified repository

Optionally filterable by:
* a `branch` name

## Path parameters

- `owner_username` string, required
- `repo_name` string, required
- `service` 'bitbucket' | 'bitbucket_server' | 'github' | 'github_enterprise' | 'gitlab' | 'gitlab_enterprise', required

## Query parameters

- `branch` string
- `page` integer
- `page_size` integer

## Response `200`

- PaginatedCommitList
  - `count` integer, required
  - `next` string, uri, nullable
  - `previous` string, uri, nullable
  - `results` Commit[], required
    - `commitid` string, required
    - `message` string, required
    - `timestamp` string, date-time, required
    - `ci_passed` boolean, required
    - `author` Owner, required
      - `service` 'github' | 'gitlab' | 'bitbucket' | 'github_enterprise' | 'gitlab_enterprise' | 'bitbucket_server', required — * `github` - Github * `gitlab` - Gitlab * `bitbucket` - Bitbucket * `github_enterprise` - Github Enterprise * `gitlab_enterprise` - Gitlab Enterprise * `bitbucket_server` - Bitbucket Server
      - `username` string, nullable, required
      - `name` string, nullable, required
    - `branch` string, required
    - `totals` CommitTotals, required
      - `files` integer, required
      - `lines` integer, required
      - `hits` integer, required
      - `misses` integer, required
      - `partials` integer, required
      - `coverage` number, double, required
      - `branches` integer, required
      - `methods` integer, required
      - `sessions` integer, required
      - `complexity` number, double, required
      - `complexity_total` number, double, required
      - `complexity_ratio` number, double, required
      - `diff` integer, required
    - `state` 'complete' | 'pending' | 'error' | 'skipped', required — * `complete` - Complete * `pending` - Pending * `error` - Error * `skipped` - Skipped
    - `parent` string, required

---

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