---
title: "List all protected branches"
method: GET
path: "/api/v4/projects/{id}/protected_branches"
tags: ["protected_branches"]
---

# List all protected branches

`GET /api/v4/projects/{id}/protected_branches`

## Request

- Base URL: `https://gitlab.com`
- URL: `https://gitlab.com/api/v4/projects/{id}/protected_branches`
- Auth: none declared

Lists all protected branches for a specified project.

## Path parameters

- `id` string, required

## Query parameters

- `page` integer
- `per_page` integer
- `search` string

## Response `200`

List all protected branches

- APIEntitiesProtectedBranch[]
  - `id` integer, required
  - `name` string, required
  - `push_access_levels` APIEntitiesProtectedRefAccess[], required
    - `id` integer, required
    - `access_level` integer, required
    - `access_level_description` string, required
    - `deploy_key_id` integer
    - `user_id` integer, required
    - `group_id` integer, required
    - `member_role_id` integer
    - `member_role_name` string
  - `merge_access_levels` APIEntitiesProtectedRefAccess[], required
    - `id` integer, required
    - `access_level` integer, required
    - `access_level_description` string, required
    - `deploy_key_id` integer
    - `user_id` integer, required
    - `group_id` integer, required
    - `member_role_id` integer
    - `member_role_name` string
  - `allow_force_push` boolean, required
  - `unprotect_access_levels` APIEntitiesProtectedRefAccess[], required
    - `id` integer, required
    - `access_level` integer, required
    - `access_level_description` string, required
    - `deploy_key_id` integer
    - `user_id` integer, required
    - `group_id` integer, required
    - `member_role_id` integer
    - `member_role_name` string
  - `code_owner_approval_required` boolean, required
  - `inherited` boolean, required

## Other responses

- `401`: 401 Unauthorized
- `404`: 404 Project Not Found

---

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