How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

GitHub Pulls API

Interact with GitHub Pull Requests.

GitHub Pulls API is one of 350 APIs that GitHub publishes on the APIs.io network, described by a machine-readable OpenAPI specification and an AsyncAPI event-driven specification.

Tagged areas include Pulls. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an AsyncAPI specification, and an API reference.

This API exposes 27 operations across 16 paths, and defines 26 schemas. It is described by OpenAPI 3.2.0, at version 1.1.4.

Requests are made against a single base URL, {protocol}://{hostname}/api/v3.

27 operations 16 paths 26 schemas 3 DELETE12 GET2 PATCH6 POST4 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.1.4
Base URL
https://api.github.com
Contact
License
Terms of Service
Resource Areas
1

Paths & Operations 27

Across 16 paths, the API surfaces 27 operations — 3 DELETE, 12 GET, 2 PATCH, 6 POST, 4 PUT. Each is listed below with its method, path, parameters, and response codes.

Pulls 27

Interact with GitHub Pull Requests.

GET
/repos/{owner}/{repo}/pulls
GitHub List Pull Requests
pulls/list 9 params → 200304422
POST
/repos/{owner}/{repo}/pulls
GitHub Create a Pull Request
pulls/create 2 params body → 201403422
GET
/repos/{owner}/{repo}/pulls/comments
GitHub List Review Comments in a Repository
pulls/list-review-comments-for-repo 7 params → 200
GET
/repos/{owner}/{repo}/pulls/comments/{comment_id}
GitHub Get a Review Comment for a Pull Request
pulls/get-review-comment 3 params → 200404
PATCH
/repos/{owner}/{repo}/pulls/comments/{comment_id}
GitHub Update a Review Comment for a Pull Request
pulls/update-review-comment 3 params body → 200
DELETE
/repos/{owner}/{repo}/pulls/comments/{comment_id}
GitHub Delete a Review Comment for a Pull Request
pulls/delete-review-comment 3 params → 204404
GET
/repos/{owner}/{repo}/pulls/{pull_number}
GitHub Get a Pull Request
pulls/get 3 params → 200304404500503
PATCH
/repos/{owner}/{repo}/pulls/{pull_number}
GitHub Update a Pull Request
pulls/update 3 params body → 200403422
GET
/repos/{owner}/{repo}/pulls/{pull_number}/comments
GitHub List Review Comments on a Pull Request
pulls/list-review-comments 8 params → 200
POST
/repos/{owner}/{repo}/pulls/{pull_number}/comments
GitHub Create a Review Comment for a Pull Request
pulls/create-review-comment 3 params body → 201403422
POST
/repos/{owner}/{repo}/pulls/{pull_number}/comments/{comment_id}/replies
GitHub Create a Reply for a Review Comment
pulls/create-reply-for-review-comment 4 params body → 201404
GET
/repos/{owner}/{repo}/pulls/{pull_number}/commits
GitHub List Commits on a Pull Request
pulls/list-commits 5 params → 200
GET
/repos/{owner}/{repo}/pulls/{pull_number}/files
GitHub List Pull Requests Files
pulls/list-files 5 params → 200422500503
GET
/repos/{owner}/{repo}/pulls/{pull_number}/merge
GitHub Check if a Pull Request Has Been Merged
pulls/check-if-merged 3 params → 204404
PUT
/repos/{owner}/{repo}/pulls/{pull_number}/merge
GitHub Merge a Pull Request
pulls/merge 3 params body → 200403404405409422
GET
/repos/{owner}/{repo}/pulls/{pull_number}/requested_reviewers
GitHub Get All Requested Reviewers for a Pull Request
pulls/list-requested-reviewers 3 params → 200
POST
/repos/{owner}/{repo}/pulls/{pull_number}/requested_reviewers
GitHub Request Reviewers for a Pull Request
pulls/request-reviewers 3 params body → 201403422
DELETE
/repos/{owner}/{repo}/pulls/{pull_number}/requested_reviewers
GitHub Remove Requested Reviewers from a Pull Request
pulls/remove-requested-reviewers 3 params body → 200422
GET
/repos/{owner}/{repo}/pulls/{pull_number}/reviews
GitHub List Reviews for a Pull Request
pulls/list-reviews 5 params → 200
POST
/repos/{owner}/{repo}/pulls/{pull_number}/reviews
GitHub Create a Review for a Pull Request
pulls/create-review 3 params body → 200403422
GET
/repos/{owner}/{repo}/pulls/{pull_number}/reviews/{review_id}
GitHub Get a Review for a Pull Request
pulls/get-review 4 params → 200404
PUT
/repos/{owner}/{repo}/pulls/{pull_number}/reviews/{review_id}
GitHub Update a Review for a Pull Request
pulls/update-review 4 params body → 200422
DELETE
/repos/{owner}/{repo}/pulls/{pull_number}/reviews/{review_id}
GitHub Delete a Pending Review for a Pull Request
pulls/delete-pending-review 4 params → 200404422
GET
/repos/{owner}/{repo}/pulls/{pull_number}/reviews/{review_id}/comments
GitHub List Comments for a Pull Request Review
pulls/list-comments-for-review 6 params → 200404
PUT
/repos/{owner}/{repo}/pulls/{pull_number}/reviews/{review_id}/dismissals
GitHub Dismiss a Review for a Pull Request
pulls/dismiss-review 4 params body → 200404422
POST
/repos/{owner}/{repo}/pulls/{pull_number}/reviews/{review_id}/events
GitHub Submit a Review for a Pull Request
pulls/submit-review 4 params body → 200403404422
PUT
/repos/{owner}/{repo}/pulls/{pull_number}/update-branch
GitHub Update a Pull Request Branch
pulls/update-branch 3 params body → 202403422

Schemas 26

The contract defines 26 schemas that model the data the API accepts and returns. The most detailed are repository (95 properties), pull-request (48 properties), pull-request-simple (36 properties), pull-request-review-comment (29 properties). Each schema is shown below with its type and property counts.

pull-request-review-request
object
Pull Request Review Request
2 properties 2 required
validation-error-simple
object
Validation Error Simple
3 properties 2 required
link
object
Hypermedia Link
1 property 1 required
team
object
Groups of organization members that gives permissions on specified repositories.
13 properties 11 required
pull-request
object
Pull requests let you tell others about changes you've pushed to a repository on GitHub. Once a pull request is sent, interested parties can review the set of…
48 properties 42 required
diff-entry
object
Diff Entry
11 properties 9 required
commit
object
Commit
11 properties 9 required
simple-user
object
A GitHub user.
21 properties 18 required
nullable-git-user
objectnull
Metaproperties for Git author/committer information.
3 properties
repository
object
A repository on GitHub.
95 properties 73 required
pull-request-review
object
Pull Request Reviews are reviews on pull requests.
13 properties 10 required
validation-error
object
Validation Error
3 properties 2 required
basic-error
object
Basic Error
4 properties
verification
object
4 properties 4 required
team-simple
object
Groups of organization members that gives permissions on specified repositories.
12 properties 10 required
pull-request-simple
object
Pull Request Simple
36 properties 31 required
nullable-team-simple
objectnull
Groups of organization members that gives permissions on specified repositories.
12 properties 10 required
reaction-rollup
object
10 properties 10 required
pull-request-merge-result
object
Pull Request Merge Result
3 properties 3 required
review-comment
object
Legacy Review Comment
28 properties 18 required
auto-merge
objectnull
The status of auto merging a pull request.
4 properties 4 required
pull-request-review-comment
object
Pull Request Review Comments are comments on a portion of the Pull Request's diff.
29 properties 16 required
author-association
string
How the author is associated with the repository.
nullable-simple-user
objectnull
A GitHub user.
21 properties 18 required
nullable-milestone
objectnull
A collection of related issues and pull requests.
16 properties 16 required
nullable-license-simple
objectnull
License Simple
6 properties 5 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

github-pulls-api-openapi.yml Raw ↑

Other APIs GitHub publishes across the network.

GitHub Events API
GitHub Feeds API
GitHub Gists API
GitHub Issues API
GitHub Licenses API
GitHub Markdown API
GitHub Meta API
GitHub Notifications API
GitHub Octocat API
GitHub Projects API
GitHub Repos API
GitHub Search API
Where this information came from

This is an independent, third-party profile of GitHub Pulls API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.