# Get pull request review protection

From **GitHub v3 REST API**.

`GET /repos/{owner}/{repo}/branches/{branch}/protection/required_pull_request_reviews`

Protected branches are available in public repositories with GitHub Free and GitHub Free for organizations, and in public and private repositories with GitHub Pro, GitHub Team, GitHub Enterprise Cloud, and GitHub Enterprise Server. For more information, see [GitHub's products](https://docs.github.com/github/getting-started-with-github/githubs-products) in the GitHub Help documentation.

## Parameters

### `owner`

- Location: path
- Required: true
- Type: `string`

### `repo`

- Location: path
- Required: true
- Type: `string`

### `branch`

- Location: path
- Required: true
- Type: `string`

The name of the branch.

## Responses

### `200`

Response

### `application/json`

- Type: `object`

Protected Branch Pull Request Review

```json
{
  "dismiss_stale_reviews": true,
  "dismissal_restrictions": {
    "teams": [
      {
        "description": "A great team.",
        "html_url": "https://github.com/orgs/github/teams/justice-league",
        "id": 1,
        "members_url": "https://api.github.com/teams/1/members{/member}",
        "name": "Justice League",
        "node_id": "MDQ6VGVhbTE=",
        "parent": null,
        "permission": "admin",
        "privacy": "closed",
        "repositories_url": "https://api.github.com/teams/1/repos",
        "slug": "justice-league",
        "url": "https://api.github.com/teams/1"
      }
    ],
    "teams_url": "https://api.github.com/repos/octocat/Hello-World/branches/master/protection/dismissal_restrictions/teams",
    "url": "https://api.github.com/repos/octocat/Hello-World/branches/master/protection/dismissal_restrictions",
    "users": [
      {
        "avatar_url": "https://github.com/images/error/octocat_happy.gif",
        "events_url": "https://api.github.com/users/octocat/events{/privacy}",
        "followers_url": "https://api.github.com/users/octocat/followers",
        "following_url": "https://api.github.com/users/octocat/following{/other_user}",
        "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
        "gravatar_id": "",
        "html_url": "https://github.com/octocat",
        "id": 1,
        "login": "octocat",
        "node_id": "MDQ6VXNlcjE=",
        "organizations_url": "https://api.github.com/users/octocat/orgs",
        "received_events_url": "https://api.github.com/users/octocat/received_events",
        "repos_url": "https://api.github.com/users/octocat/repos",
        "site_admin": false,
        "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
        "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
        "type": "User",
        "url": "https://api.github.com/users/octocat"
      }
    ],
    "users_url": "https://api.github.com/repos/octocat/Hello-World/branches/master/protection/dismissal_restrictions/users"
  },
  "require_code_owner_reviews": true,
  "required_approving_review_count": 2,
  "url": "https://api.github.com/repos/octocat/Hello-World/branches/master/protection/required_pull_request_reviews"
}
```

```json
{"description":"Protected Branch Pull Request Review","properties":{"dismiss_stale_reviews":{"example":true,"type":"boolean"},"dismissal_restrictions":{"properties":{"teams":{"description":"The list of teams with review dismissal access.","items":{"$ref":"#/components/schemas/team"},"type":"array"},"teams_url":{"example":"\"https://api.github.com/repos/the-org/an-org-repo/branches/master/protection/dismissal_restrictions/teams\"","type":"string"},"url":{"example":"\"https://api.github.com/repos/the-org/an-org-repo/branches/master/protection/dismissal_restrictions\"","type":"string"},"users":{"description":"The list of users with review dismissal access.","items":{"$ref":"#/components/schemas/simple-user"},"type":"array"},"users_url":{"example":"\"https://api.github.com/repos/the-org/an-org-repo/branches/master/protection/dismissal_restrictions/users\"","type":"string"}},"type":"object"},"require_code_owner_reviews":{"example":true,"type":"boolean"},"required_approving_review_count":{"example":2,"maximum":6,"minimum":1,"type":"integer"},"url":{"example":"https://api.github.com/repos/octocat/Hello-World/branches/master/protection/dismissal_restrictions","format":"uri","type":"string"}},"required":["dismiss_stale_reviews","require_code_owner_reviews"],"title":"Protected Branch Pull Request Review","type":"object"}
```

## Request examples

### cURL

```shell
curl --request GET \
  --url {protocol}://{hostname}/api/v3/repos/{owner}/{repo}/branches/{branch}/protection/required_pull_request_reviews
```