Development — entry 028 of 100
GitHub
GitHub's REST API exposes nearly every platform object — repositories, issues, pull requests, Actions runs, packages, and user/org data — as JSON over versioned, stable endpoints. It's free to call with a personal access token, fine-grained PAT, OAuth app, or GitHub App, rate-limited to 5,000 requests/hour authenticated (60/hour unauthenticated), with a parallel GraphQL API for clients that want to fetch nested data in one round trip.
GreatAPIs Score
Embed this badge
<a href="https://greatapis.com/api/github/"><img src="https://greatapis.com/badge/github.svg" alt="Scored 83 on greatapis.com"></a>Auth quickstart
- Register an app / run the OAuth flow to obtain a bearer token.
- Send it as an Authorization header
Authorization: Bearer <token>
Your key is stored only in this browser (localStorage) and sent directly to the API — never to greatapis.
Endpoints
issues2
Interact with GitHub Issues.
GET/repos/{owner}/{repo}/issuesList repository issues
| Name | In | Required | Type |
|---|---|---|---|
milestone | query | no | string |
state | query | no | string |
assignee | query | no | string |
type | query | no | string |
creator | query | no | string |
mentioned | query | no | string |
issue_field_values | query | no | string |
sort | query | no | string |
| Status | Description | Schema |
|---|---|---|
200 | Response | — |
301 | — | — |
404 | — | — |
422 | — | — |
POST/repos/{owner}/{repo}/issuesCreate an issue
application/json (required)
| Status | Description | Schema |
|---|---|---|
201 | Response | issue |
400 | — | — |
403 | — | — |
404 | — | — |
410 | — | — |
422 | — | — |
503 | — | — |
orgs1
Interact with organizations.
GET/orgs/{org}Get an organization
| Status | Description | Schema |
|---|---|---|
200 | Response | organization-full |
404 | — | — |
pulls2
Interact with GitHub Pull Requests.
GET/repos/{owner}/{repo}/pullsList pull requests
| Name | In | Required | Type |
|---|---|---|---|
state | query | no | string |
head | query | no | string |
base | query | no | string |
sort | query | no | string |
direction | query | no | string |
| Status | Description | Schema |
|---|---|---|
200 | Response | — |
304 | — | — |
422 | — | — |
POST/repos/{owner}/{repo}/pullsCreate a pull request
application/json (required)
| Status | Description | Schema |
|---|---|---|
201 | Response | pull-request |
403 | — | — |
422 | — | — |
repos3
Interact with GitHub Repos.
GET/orgs/{org}/reposList organization repositories
| Name | In | Required | Type |
|---|---|---|---|
type | query | no | string |
sort | query | no | string |
direction | query | no | string |
| Status | Description | Schema |
|---|---|---|
200 | Response | — |
GET/repos/{owner}/{repo}Get a repository
| Status | Description | Schema |
|---|---|---|
200 | Response | full-repository |
301 | — | — |
403 | — | — |
404 | — | — |
GET/repos/{owner}/{repo}/commitsList commits
| Name | In | Required | Type |
|---|---|---|---|
sha | query | no | string |
path | query | no | string |
author | query | no | string |
committer | query | no | string |
since | query | no | string |
until | query | no | string |
| Status | Description | Schema |
|---|---|---|
200 | Response | — |
400 | — | — |
404 | — | — |
409 | — | — |
500 | — | — |
search3
Search for specific items on GitHub.
GET/search/codeSearch code
| Name | In | Required | Type |
|---|---|---|---|
q | query | yes | string |
sort | query | no | string |
order | query | no | string |
| Status | Description | Schema |
|---|---|---|
200 | Response | — |
304 | — | — |
403 | — | — |
422 | — | — |
503 | — | — |
GET/search/issuesSearch issues and pull requests
| Name | In | Required | Type |
|---|---|---|---|
q | query | yes | string |
sort | query | no | string |
| Status | Description | Schema |
|---|---|---|
200 | Response | — |
304 | — | — |
401 | — | — |
403 | — | — |
422 | — | — |
503 | — | — |
GET/search/repositoriesSearch repositories
| Name | In | Required | Type |
|---|---|---|---|
q | query | yes | string |
sort | query | no | string |
| Status | Description | Schema |
|---|---|---|
200 | Response | — |
304 | — | — |
422 | — | — |
503 | — | — |
users1
Interact with and view information about users and also current user.
GET/users/{username}Get a user
| Status | Description | Schema |
|---|---|---|
200 | Response | — |
404 | — | — |
Try it
Developer reference
https://api.github.com5,000 requests/hour authenticated; 60 requests/hour unauthenticated
- GET/repos/{owner}/{repo}
- GET/repos/{owner}/{repo}/issues
- POST/repos/{owner}/{repo}/issues
- GET/search/repositories
- GET/users/{username}