---
title: "List GitHub check runs"
method: GET
path: "/v1/check-runs"
tags: ["GitHub Check Runs"]
---

# List GitHub check runs

`GET /v1/check-runs`

## Request

- Base URL: `https://api.gitguardian.com`
- URL: `https://api.gitguardian.com/v1/check-runs`
- Auth: HTTP bearer

List the GitHub check runs that GitGuardian ran on pull requests, from the most
recent to the oldest.

Filter on `incident_id` to get the check runs that reported a secret incident.
Then skip a blocking one with the skip endpoint.

Only Manager personal access tokens and service account tokens can list check
runs.

## Query parameters

- `cursor` string
- `per_page` integer
- `ordering` 'id' | '-id' | 'created_at' | '-created_at'
- `incident_id` integer

## Response `200`

Check Run List

- object[]
  - `id` integer
  - `created_at` string, date-time
  - `repository_full_name` string: Full name of the GitHub repository
  - `commit_sha` string: SHA of the head commit the check run evaluated
  - `pull_requests` object[]: Pull requests the check run is reported on (10 at most)
    - `number` integer
    - `state` 'OPEN' | 'CLOSED' | 'MERGED'
    - `head_branch` string, nullable
    - `base_branch` string, nullable
  - `github_status` 'queued' | 'in_progress' | 'completed': Status of the check run on GitHub
  - `github_conclusion` 'action_required' | 'cancelled' | 'failure' | 'neutral' | 'success' | 'skipped' | 'stale' | 'timed_out', nullable: Conclusion of the check run on GitHub. Null while the check run is running.
  - `ignored_at` string, date-time, nullable: Date the check run was skipped
  - `ignore_reason` 'false_positive' | 'low_risk' | 'test_credential' | 'skipped_from_fork', nullable: Reason given when the check run was skipped. `skipped_from_fork` is set when the check run of a pull request from a fork is skipped on GitHub.

## Other responses

- `400`: Invalid data
- `401`: Invalid API key
- `403`: Permission denied
- `503`: API under maintenance

## Changes

- **2026-10-16** `dbe1b6116db5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/gitguardian/apis/gitguardian-api/changes/v1/check-runs/get.md)

---

[API](https://skmtc.dev/gitguardian/apis/gitguardian-api.md) - [All operations](https://skmtc.dev/gitguardian/apis/gitguardian-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gitguardian/apis/gitguardian-api/revisions/5829df7b9045?raw)