---
title: "List PRs for a watched branch"
method: GET
path: "/api/v1alpha/watched_branches/{branch}/prs"
tags: ["PRs"]
---

# List PRs for a watched branch

`GET /api/v1alpha/watched_branches/{branch}/prs`

## Request

- Base URL: `{{ base_url }}`
- URL: `{{ base_url }}/api/v1alpha/watched_branches/{branch}/prs`
- Auth: none declared

Returns all active PRs for the given branch with build and review state.

## Path parameters

- `branch` string, required

## Response `200`

PR list retrieved successfully

- PRConfig[]
  - `number` integer
  - `title` string
  - `author` string
  - `assignees` string[]
  - `reviewers` string[]
  - `source_branch_name` string
  - `build_state` string, nullable
  - `review_state` string, nullable
  - `labels` string[]
  - `out_of_date` boolean
  - `gh_statuses` object
  - `batch_id` integer, nullable

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Branch not found

## Changes

- **2026-07-30** `37d6dddb7b5a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/hail-is/apis/hail-ci-service/changes/api/v1alpha/watched_branches/:branch/prs/get.md)

---

[API](https://skmtc.dev/hail-is/apis/hail-ci-service.md) - [All operations](https://skmtc.dev/hail-is/apis/hail-ci-service/llms.txt) - [OpenAPI document](https://skmtc.dev/hail-is/apis/hail-ci-service/revisions/a60fc5e80878?raw)