---
title: "Comparison"
method: GET
path: "/{service}/{owner_username}/repos/{repo_name}/compare/"
tags: ["Comparison"]
---

# Comparison

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

Returns a comparison for either a pair of commits or a pull

## Path parameters

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

## Query parameters

- `base` string
- `head` string
- `pullid` integer

## Response `200`

- Comparison
  - `base_commit` string, required
  - `head_commit` string, required
  - `totals` TotalsComparison, required
    - `base` ReportTotals, 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
      - `messages` integer, required
      - `sessions` integer, required
      - `complexity` number, double, required
      - `complexity_total` number, double, required
      - `complexity_ratio` number, double, required
      - `diff` unknown, required
    - `head` ReportTotals, 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
      - `messages` integer, required
      - `sessions` integer, required
      - `complexity` number, double, required
      - `complexity_total` number, double, required
      - `complexity_ratio` number, double, required
      - `diff` unknown, required
    - `patch` ReportTotals, 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
      - `messages` integer, required
      - `sessions` integer, required
      - `complexity` number, double, required
      - `complexity_total` number, double, required
      - `complexity_ratio` number, double, required
      - `diff` unknown, required
  - `commit_uploads` 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
  - `diff` object, required
  - `files` object[], required
  - `untracked` 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)