GitHub REST API documentation
Create integrations, retrieve data, and automate your workflows with the GitHub REST API.
Start here
View allAbout the REST API
Get oriented to the REST API documentation.
Getting started with the REST API
Learn how to use the GitHub REST API.
Authenticating to the REST API
You can authenticate to the REST API to access more endpoints and have a higher rate limit.
Best practices for using the REST API
Follow these best practices when using GitHub's API.
Popular
Rate limits for the REST API
Learn about REST API rate limits, how to avoid exceeding them, and what to do if you do exceed them.
Troubleshooting the REST API
Learn how to diagnose and resolve common problems for the REST API.
Scripting with the REST API and JavaScript
Write a script using the Octokit.js SDK to interact with the REST API.
Keeping your API credentials secure
Follow these best practices to keep your API credentials and tokens secure.
Delivering deployments
Using the Deployments REST API, you can build custom tooling that interacts with your server and a third-party app.
Using the REST API to interact with checks
You can use the REST API to build GitHub Apps that run powerful checks against code changes in a repository. You can create apps that perform continuous integration, code linting, or code scanning services and provide detailed feedback on commits.
Using pagination in the REST API
Learn how to navigate through paginated responses from the REST API.
Authenticating to the REST API
- Authenticating to the REST API
- Keeping your API credentials secure
- Endpoints available for GitHub App installation access tokens
- Endpoints available for GitHub App user access tokens
- Endpoints available for fine-grained personal access tokens
- Permissions required for GitHub Apps
- Permissions required for fine-grained personal access tokens
Guides
- Scripting with the REST API and JavaScript
- Scripting with the REST API and Ruby
- Discovering resources for a user
- Delivering deployments
- Rendering data as graphs
- Working with comments
- Building a CI server
- Using the REST API to interact with your Git database
- Using the REST API to interact with checks
- Encrypting secrets for the REST API
REST API endpoints for GitHub Actions
- REST API endpoints for GitHub Actions artifacts
- REST API endpoints for GitHub Actions cache
- REST API endpoints for GitHub Actions OIDC
- REST API endpoints for GitHub Actions permissions
- REST API endpoints for GitHub Actions Secrets
- REST API endpoints for self-hosted runner groups
- REST API endpoints for self-hosted runners
- REST API endpoints for GitHub Actions variables
- REST API endpoints for workflow jobs
- REST API endpoints for workflow runs
- REST API endpoints for workflows
REST API endpoints for GitHub Enterprise administration
- REST API endpoints for admin stats
- REST API endpoints for global announcements
- REST API endpoints for enterprise audit logs
- REST API endpoints for enterprise billing
- REST API endpoints for enterprise security features for code
- REST API endpoints for global webhooks
- REST API endpoints for LDAP
- REST API endpoints for enterprise licenses
- REST API endpoints for managing GitHub Enterprise Server
- REST API endpoints for Management Console
- REST API endpoints for organization pre-receive hooks
- REST API endpoints for enterprise organizations
- REST API endpoints for pre-receive environments
- REST API endpoints for pre-receive hooks
- REST API endpoints for repository pre-receive hooks
- REST API endpoints for SCIM
- REST API endpoints for enterprise users
REST API endpoints for organizations
- REST API endpoints for custom properties
- REST API endpoints for custom repository roles
- REST API endpoints for organization members
- REST API endpoints for organization roles
- REST API endpoints for organizations
- REST API endpoints for outside collaborators
- REST API endpoints for personal access tokens
- REST API endpoints for rule suites
- REST API endpoints for rules
- REST API endpoints for security managers
- REST API endpoints for organization webhooks
REST API endpoints for repositories
- REST API endpoints for repository autolinks
- REST API endpoints for repository contents
- REST API endpoints for custom properties
- REST API endpoints for forks
- REST API endpoints for Git LFS
- REST API endpoints for repositories
- REST API endpoints for rule suites
- REST API endpoints for rules
- REST API endpoints for repository tags
- REST API endpoints for repository webhooks