List app installations for an organization
Lists all GitHub Apps in an organization. The installation count includes all GitHub Apps installed on repositories in the organization.
The authenticated user must be an organization owner to use this endpoint.
OAuth app tokens and personal access tokens (classic) need the admin:read scope to use this endpoint.
Parameters
Section titled “ Parameters ”Path Parameters
Section titled “ Path Parameters ”The organization name. The name is not case sensitive.
Query Parameters
Section titled “ Query Parameters ”The number of results per page (max 100). For more information, see “Using pagination in the REST API.”
The page number of the results to fetch. For more information, see “Using pagination in the REST API.”
Responses
Section titled “ Responses ”Response
object
Installation
object
The ID of the installation.
A GitHub user.
object
An enterprise on GitHub.
object
A short description of the enterprise.
The enterprise’s website URL.
Unique identifier of the enterprise
The name of the enterprise.
The slug url identifier for the enterprise.
Describe whether all repositories have been selected or there’s a selection involved
The ID of the user or organization this token is being scoped to.
The permissions granted to the fine-grained access token.
object
The level of permission to grant the access token for GitHub Actions workflows, workflow runs, and artifacts.
The level of permission to grant the access token for repository creation, deletion, settings, teams, and collaborators creation.
The level of permission to grant the access token to create and retrieve build artifact metadata records.
The level of permission to create and retrieve the access token for repository attestations.
The level of permission to grant the access token for checks on code.
The level of permission to grant the access token to view and manage code quality data.
The level of permission to grant the access token to create, edit, delete, and list Codespaces.
The level of permission to grant the access token for repository contents, commits, branches, downloads, releases, and merges.
The level of permission to grant the access token to manage Dependabot secrets.
The level of permission to grant the access token for deployments and deployment statuses.
The level of permission to grant the access token for discussions and related comments and labels.
The level of permission to grant the access token for managing repository environments.
The level of permission to grant the access token for issues and related comments, assignees, labels, and milestones.
The level of permission to grant the access token to manage the merge queues for a repository.
The level of permission to grant the access token to search repositories, list collaborators, and access repository metadata.
The level of permission to grant the access token for packages published to GitHub Packages.
The level of permission to grant the access token to retrieve Pages statuses, configuration, and builds, as well as create new builds.
The level of permission to grant the access token for pull requests and related comments, assignees, labels, milestones, and merges.
The level of permission to grant the access token to view and edit custom properties for a repository, when allowed by the property.
The level of permission to grant the access token to manage the post-receive hooks for a repository.
The level of permission to grant the access token to manage repository projects, columns, and cards.
The level of permission to grant the access token to view and manage secret scanning alerts.
The level of permission to grant the access token to manage repository secrets.
The level of permission to grant the access token to view and manage security events like code scanning alerts.
The level of permission to grant the access token to manage just a single file.
The level of permission to grant the access token for commit statuses.
The level of permission to grant the access token to manage Dependabot alerts.
The level of permission to grant the access token to update GitHub Actions workflow files.
The level of permission to grant the access token to view and edit custom properties for an organization, when allowed by the property.
The level of permission to grant the access token for organization teams and members.
The level of permission to grant the access token to manage access to an organization.
The level of permission to grant the access token for custom repository roles management.
The level of permission to grant the access token for custom organization roles management.
The level of permission to grant the access token for repository custom properties management at the organization level.
The level of permission to grant the access token for managing access to GitHub Copilot for members of an organization with a Copilot Business subscription. This property is in public preview and is subject to change.
The level of permission to grant the access token to view and manage Copilot cloud agent settings for an organization.
The level of permission to grant the access token to view and manage announcement banners for an organization.
The level of permission to grant the access token to view events triggered by an activity in an organization.
The level of permission to grant the access token to manage the post-receive hooks for an organization.
The level of permission to grant the access token for viewing and managing fine-grained personal access token requests to an organization.
The level of permission to grant the access token for viewing and managing fine-grained personal access tokens that have been approved by an organization.
The level of permission to grant the access token for viewing an organization’s plan.
The level of permission to grant the access token to manage organization projects and projects public preview (where available).
The level of permission to grant the access token for organization packages published to GitHub Packages.
The level of permission to grant the access token to manage organization secrets.
The level of permission to grant the access token to view and manage GitHub Actions self-hosted runners available to an organization.
The level of permission to grant the access token to view and manage users blocked by the organization.
The level of permission to grant the access token to manage the email addresses belonging to a user.
The level of permission to grant the access token to manage the followers belonging to a user.
The level of permission to grant the access token to manage git SSH keys.
The level of permission to grant the access token to view and manage GPG keys belonging to a user.
The level of permission to grant the access token to view and manage interaction limits on a repository.
The level of permission to grant the access token to manage the profile settings belonging to a user.
The level of permission to grant the access token to list and manage repositories a user is starring.
The level of permission to grant the access token for organization custom properties management at the enterprise level.
A GitHub user.
object
Examples
{ "total_count": 1, "installations": [ { "id": 25381, "account": { "login": "octo-org", "id": 6811672, "node_id": "MDEyOk9yZ2FuaXphdGlvbjY4MTE2NzI=", "avatar_url": "https://avatars3.githubusercontent.com/u/6811672?v=4", "gravatar_id": "", "url": "https://api.github.com/users/octo-org", "html_url": "https://github.com/octo-org", "followers_url": "https://api.github.com/users/octo-org/followers", "following_url": "https://api.github.com/users/octo-org/following{/other_user}", "gists_url": "https://api.github.com/users/octo-org/gists{/gist_id}", "starred_url": "https://api.github.com/users/octo-org/starred{/owner}{/repo}", "subscriptions_url": "https://api.github.com/users/octo-org/subscriptions", "organizations_url": "https://api.github.com/users/octo-org/orgs", "repos_url": "https://api.github.com/users/octo-org/repos", "events_url": "https://api.github.com/users/octo-org/events{/privacy}", "received_events_url": "https://api.github.com/users/octo-org/received_events", "type": "Organization", "site_admin": false }, "repository_selection": "selected", "access_tokens_url": "https://api.github.com/app/installations/25381/access_tokens", "repositories_url": "https://api.github.com/installation/repositories", "html_url": "https://github.com/organizations/octo-org/settings/installations/25381", "app_id": 2218, "target_id": 6811672, "target_type": "Organization", "permissions": { "deployments": "write", "metadata": "read", "pull_requests": "read", "statuses": "read" }, "events": [ "deployment", "deployment_status" ], "created_at": "2017-05-16T08:47:09.000-07:00", "updated_at": "2017-06-06T11:23:23.000-07:00", "single_file_name": "config.yml", "has_multiple_single_files": true, "single_file_paths": [ "config.yml", ".github/issue_TEMPLATE.md" ], "app_slug": "github-actions", "suspended_at": null, "suspended_by": null } ]}Headers
Section titled “ Headers ”Example
<https://api.github.com/resource?page=2>; rel="next", <https://api.github.com/resource?page=5>; rel="last"