---
title: "Retrieve a protected branch or wildcard protected branch"
method: GET
path: "/api/v4/projects/{id}/protected_branches/{name}"
tags: ["protected_branches"]
---

# Retrieve a protected branch or wildcard protected branch

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

## Request

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

Retrieves a specified protected branch or wildcard protected branch.

## Path parameters

- `id` string, required
- `name` string, required

## Response `200`

Retrieve a protected branch or wildcard protected branch

- APIEntitiesProtectedBranch: API_Entities_ProtectedBranch model
  - `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)