---
title: "Get a concurrency group for a repository"
method: GET
path: "/repos/{owner}/{repo}/actions/concurrency_groups/{concurrency_group_name}"
tags: ["actions"]
---

# Get a concurrency group for a repository

`GET /repos/{owner}/{repo}/actions/concurrency_groups/{concurrency_group_name}`

Gets a specific concurrency group for a repository, including all instances in the group's queue.
Returns 404 if the group is inactive or does not exist.

Optionally, pass `ahead_of_run` or `ahead_of_job` to filter the results to only the items
ahead of the specified workflow run or job in the queue, plus the specified item itself
(returned as the last element). This is useful for determining what is blocking a particular
run or job. Returns 422 if the specified run or job is not in this concurrency group.

When using `ahead_of_run`, this matches workflow-level concurrency and any reusable-workflow
leases held on behalf of that run. Job-level leases within the run are not considered to
block the run as a whole. Use `ahead_of_job` to match job-level concurrency and reusable-workflow
leases on the job's ancestor paths.

OAuth app tokens and personal access tokens (classic) need the `repo` scope to use this endpoint with a private repository.

## Path parameters

- `owner` string, required
- `repo` string, required
- `concurrency_group_name` string, required

## Query parameters

- `ahead_of_run` integer
- `ahead_of_job` integer

## Response `200`

Response

- ConcurrencyGroup — A concurrency group with the workflow runs and jobs that are either currently holding or waiting for the concurrency group lease.
  - `group_name` string, required — The name of the concurrency group.
  - `group_url` string, uri, required — API URL for this concurrency group.
  - `total_count` integer, required
  - `group_members` object[], required
    - `run_id` integer, required — The ID of the workflow run.
    - `run_name` string, required — The name of the workflow run.
    - `run_url` string, uri, nullable, required — API URL for the workflow run.
    - `run_html_url` string, uri, nullable, required — Web URL for the workflow run.
    - `job_id` integer — The ID of the job, when the item represents a job-level or reusable-workflow-level lease.
    - `job_name` string — The display name of the job, when the item represents a job-level or reusable-workflow-level lease.
    - `job_url` string, uri, nullable — API URL for the job.
    - `job_html_url` string, uri, nullable — Web URL for the job.
    - `status` 'in_progress' | 'pending', required

## Other responses

- `404` — Resource not found
- `422` — Validation failed, or the endpoint has been spammed.

---

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