---
title: "Get an organization"
method: GET
path: "/orgs/{org}"
tags: ["orgs"]
---

# Get an organization

`GET /orgs/{org}`

Gets information about an organization.

When the value of `two_factor_requirement_enabled` is `true`, the organization requires all members, billing managers, outside collaborators, guest collaborators, repository collaborators, or everyone with access to any repository within the organization to enable [two-factor authentication](https://docs.github.com/enterprise-cloud@latest/articles/securing-your-account-with-two-factor-authentication-2fa/).

To see the full details about an organization, the authenticated user must be an organization owner.

OAuth app tokens and personal access tokens (classic) need the `admin:org` scope to see the full details about an organization.

To see information about an organization's GitHub Enterprise Cloud plan, GitHub Apps need the `Organization plan` permission.

## Path parameters

- `org` string, required

## Response `200`

Response

- OrganizationFull — Prevents users in the organization from using insecure methods of two-factor authentication to fulfill a two-factor requirement. Removes non-compliant outside collaborators from the organization and its repositories. GitHub currently defines SMS as an insecure method of two-factor authentication. If your users are managed by the enterprise this policy will not affect them. The first admin account of the enterprise will still be affected.
  - `login` string, required
  - `id` integer, required
  - `node_id` string, required
  - `url` string, uri, required
  - `repos_url` string, uri, required
  - `events_url` string, uri, required
  - `hooks_url` string, required
  - `issues_url` string, required
  - `members_url` string, required
  - `public_members_url` string, required
  - `avatar_url` string, required
  - `description` string, nullable, required
  - `name` string
  - `company` string
  - `blog` string, uri
  - `location` string
  - `email` string, email
  - `twitter_username` string, nullable
  - `is_verified` boolean
  - `has_organization_projects` boolean, required
  - `has_repository_projects` boolean, required
  - `public_repos` integer, required
  - `public_gists` integer, required
  - `followers` integer, required
  - `following` integer, required
  - `html_url` string, uri, required
  - `type` string, required
  - `total_private_repos` integer
  - `owned_private_repos` integer
  - `private_gists` integer, nullable
  - `disk_usage` integer, nullable
  - `collaborators` integer, nullable — The number of collaborators on private repositories. This field may be null if the number of private repositories is over 50,000.
  - `billing_email` string, email, nullable
  - `plan` object
    - `name` string, required
    - `space` integer, required
    - `private_repos` integer, required
    - `filled_seats` integer
    - `seats` integer
  - `default_repository_permission` string, nullable
  - `default_repository_branch` string, nullable — The default branch for repositories created in this organization.
  - `members_can_create_repositories` boolean, nullable
  - `two_factor_requirement_enabled` boolean, nullable
  - `members_allowed_repository_creation_type` string
  - `members_can_create_public_repositories` boolean
  - `members_can_create_private_repositories` boolean
  - `members_can_create_internal_repositories` boolean
  - `members_can_create_pages` boolean
  - `members_can_create_public_pages` boolean
  - `members_can_create_private_pages` boolean
  - `members_can_delete_repositories` boolean
  - `members_can_change_repo_visibility` boolean
  - `members_can_invite_outside_collaborators` boolean
  - `members_can_delete_issues` boolean
  - `display_commenter_full_name_setting_enabled` boolean
  - `readers_can_create_discussions` boolean
  - `members_can_create_teams` boolean
  - `members_can_view_dependency_insights` boolean
  - `members_can_fork_private_repositories` boolean, nullable
  - `web_commit_signoff_required` boolean
  - `advanced_security_enabled_for_new_repositories` boolean — **Endpoint closing down notice.** Please use [code security configurations](https://docs.github.com/enterprise-cloud@latest/rest/code-security/configurations) instead. Whether GitHub Advanced Security is enabled for new repositories and repositories transferred to this organization. This field is only visible to organization owners or members of a team with the security manager role.
  - `dependabot_alerts_enabled_for_new_repositories` boolean — **Endpoint closing down notice.** Please use [code security configurations](https://docs.github.com/enterprise-cloud@latest/rest/code-security/configurations) instead. Whether Dependabot alerts are automatically enabled for new repositories and repositories transferred to this organization. This field is only visible to organization owners or members of a team with the security manager role.
  - `dependabot_security_updates_enabled_for_new_repositories` boolean — **Endpoint closing down notice.** Please use [code security configurations](https://docs.github.com/enterprise-cloud@latest/rest/code-security/configurations) instead. Whether Dependabot security updates are automatically enabled for new repositories and repositories transferred to this organization. This field is only visible to organization owners or members of a team with the security manager role.
  - `dependency_graph_enabled_for_new_repositories` boolean — **Endpoint closing down notice.** Please use [code security configurations](https://docs.github.com/enterprise-cloud@latest/rest/code-security/configurations) instead. Whether dependency graph is automatically enabled for new repositories and repositories transferred to this organization. This field is only visible to organization owners or members of a team with the security manager role.
  - `secret_scanning_enabled_for_new_repositories` boolean — **Endpoint closing down notice.** Please use [code security configurations](https://docs.github.com/enterprise-cloud@latest/rest/code-security/configurations) instead. Whether secret scanning is automatically enabled for new repositories and repositories transferred to this organization. This field is only visible to organization owners or members of a team with the security manager role.
  - `secret_scanning_push_protection_enabled_for_new_repositories` boolean — **Endpoint closing down notice.** Please use [code security configurations](https://docs.github.com/enterprise-cloud@latest/rest/code-security/configurations) instead. Whether secret scanning push protection is automatically enabled for new repositories and repositories transferred to this organization. This field is only visible to organization owners or members of a team with the security manager role.
  - `secret_scanning_push_protection_custom_link_enabled` boolean — Whether a custom link is shown to contributors who are blocked from pushing a secret by push protection.
  - `secret_scanning_push_protection_custom_link` string, nullable — An optional URL string to display to contributors who are blocked from pushing a secret.
  - `secret_scanning_validity_checks_enabled` boolean — **Endpoint closing down notice.** Please use [code security configurations](https://docs.github.com/enterprise-cloud@latest/rest/code-security/configurations) instead. Whether secret scanning automatic validity checks on supported partner tokens is enabled for all repositories under this organization.
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `archived_at` string, date-time, nullable, required
  - `deploy_keys_enabled_for_repositories` boolean — Controls whether or not deploy keys may be added and used for repositories in the organization.

## Other responses

- `404` — Resource not found

---

[API](https://skmtc.net/github/apis/github-v3-rest-api-2.md) · [All operations](https://skmtc.net/github/apis/github-v3-rest-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/github/github-v3-rest-api-2/versions/8ae6d0c8716e/schema)
