GET/orgs/{org}

Get an organization

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.

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 plan, GitHub Apps need the Organization plan permission.

RetriesRetries up to 2×, 500ms backoff, 30s timeout.

1 parameter

orgstringrequired

The organization name. The name is not case sensitive.

2 status codes

200Response

loginstringrequired

idintegerrequired

node_idstringrequired

urlstringrequired

repos_urlstringrequired

events_urlstringrequired

hooks_urlstringrequired

issues_urlstringrequired

members_urlstringrequired

public_members_urlstringrequired

avatar_urlstringrequired

descriptionstringrequired

namestringoptional

companystringoptional

blogstringoptional

locationstringoptional

emailstringoptional

twitter_usernamestringoptional

is_verifiedbooleanoptional

has_organization_projectsbooleanrequired

has_repository_projectsbooleanrequired

public_reposintegerrequired

public_gistsintegerrequired

followersintegerrequired

followingintegerrequired

html_urlstringrequired

typestringrequired

total_private_reposintegeroptional

owned_private_reposintegeroptional

private_gistsintegeroptional

disk_usageintegeroptional

collaboratorsintegeroptional

The number of collaborators on private repositories. This field may be null if the number of private repositories is over 50,000.

billing_emailstringoptional

planobjectoptional

default_repository_permissionstringoptional

default_repository_branchstringoptional

The default branch for repositories created in this organization.

members_can_create_repositoriesbooleanoptional

two_factor_requirement_enabledbooleanoptional

members_allowed_repository_creation_typestringoptional

members_can_create_public_repositoriesbooleanoptional

members_can_create_private_repositoriesbooleanoptional

members_can_create_internal_repositoriesbooleanoptional

members_can_create_pagesbooleanoptional

members_can_create_public_pagesbooleanoptional

members_can_create_private_pagesbooleanoptional

members_can_delete_repositoriesbooleanoptional

members_can_change_repo_visibilitybooleanoptional

members_can_invite_outside_collaboratorsbooleanoptional

members_can_delete_issuesbooleanoptional

display_commenter_full_name_setting_enabledbooleanoptional

readers_can_create_discussionsbooleanoptional

members_can_create_teamsbooleanoptional

members_can_view_dependency_insightsbooleanoptional

members_can_fork_private_repositoriesbooleanoptional

web_commit_signoff_requiredbooleanoptional

advanced_security_enabled_for_new_repositoriesbooleandeprecatedoptional

**Endpoint closing down notice.** Please use [code security configurations](https://docs.github.com/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_repositoriesbooleandeprecatedoptional

**Endpoint closing down notice.** Please use [code security configurations](https://docs.github.com/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_repositoriesbooleandeprecatedoptional

**Endpoint closing down notice.** Please use [code security configurations](https://docs.github.com/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_repositoriesbooleandeprecatedoptional

**Endpoint closing down notice.** Please use [code security configurations](https://docs.github.com/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_repositoriesbooleandeprecatedoptional

**Endpoint closing down notice.** Please use [code security configurations](https://docs.github.com/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_repositoriesbooleandeprecatedoptional

**Endpoint closing down notice.** Please use [code security configurations](https://docs.github.com/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_enabledbooleanoptional

Whether a custom link is shown to contributors who are blocked from pushing a secret by push protection.

secret_scanning_push_protection_custom_linkstringoptional

An optional URL string to display to contributors who are blocked from pushing a secret.

created_atstringrequired

updated_atstringrequired

archived_atstringrequired

deploy_keys_enabled_for_repositoriesbooleanoptional

Controls whether or not deploy keys may be added and used for repositories in the organization.

404Resource not found

messagestringoptional

documentation_urlstringoptional

urlstringoptional

statusstringoptional

Error handling

A 404 is returned: Resource not found.

import { Client } from "acme-sdk";

const client = new Client({
  baseUrl: "https://api.acme.com",
  auth: { bearer: process.env.API_TOKEN },
  retry: {
    maxAttempts: 3,
    retryOn: [
      408,
      425,
      429,
      500,
      502,
      503,
      504,
    ],
    backoffMs: 500,
    maxBackoffMs: 8000,
  },
  timeoutMs: 30000,
});

const result = await client.orgs.get({ org: "acme-inc" });

{
  "login": "github",
  "id": 1,
  "node_id": "MDEyOk9yZ2FuaXphdGlvbjE=",
  "url": "https://api.github.com/orgs/github",
  "repos_url": "https://api.github.com/orgs/github/repos",
  "events_url": "https://api.github.com/orgs/github/events",
  "hooks_url": "https://api.github.com/orgs/github/hooks",
  "issues_url": "https://api.github.com/orgs/github/issues",
  "members_url": "https://api.github.com/orgs/github/members{/member}",
  "public_members_url": "https://api.github.com/orgs/github/public_members{/member}",
  "avatar_url": "https://github.com/images/error/octocat_happy.gif",
  "description": "A great organization",
  "name": "github",
  "company": "GitHub",
  "blog": "https://github.com/blog",
  "location": "San Francisco",
  "email": "octocat@github.com",
  "twitter_username": "github",
  "is_verified": true,
  "has_organization_projects": true,
  "has_repository_projects": true,
  "public_repos": 2,
  "public_gists": 1,
  "followers": 20,
  "following": 0,
  "html_url": "https://github.com/octocat",
  "created_at": "2008-01-14T04:33:35Z",
  "type": "Organization",
  "total_private_repos": 100,
  "owned_private_repos": 100,
  "private_gists": 81,
  "disk_usage": 10000,
  "collaborators": 8,
  "billing_email": "mona@github.com",
  "plan": {
    "name": "Medium",
    "space": 400,
    "private_repos": 20,
    "filled_seats": 4,
    "seats": 5
  },
  "default_repository_permission": "read",
  "default_repository_branch": "main",
  "members_can_create_repositories": true,
  "two_factor_requirement_enabled": true,
  "members_allowed_repository_creation_type": "all",
  "members_can_create_public_repositories": false,
  "members_can_create_private_repositories": false,
  "members_can_create_internal_repositories": false,
  "members_can_create_pages": true,
  "members_can_create_public_pages": true,
  "members_can_create_private_pages": true,
  "members_can_delete_repositories": true,
  "members_can_change_repo_visibility": true,
  "members_can_invite_outside_collaborators": true,
  "members_can_delete_issues": false,
  "display_commenter_full_name_setting_enabled": false,
  "readers_can_create_discussions": true,
  "members_can_create_teams": true,
  "members_can_view_dependency_insights": true,
  "members_can_fork_private_repositories": false,
  "web_commit_signoff_required": false,
  "updated_at": "2014-03-03T18:58:10Z",
  "deploy_keys_enabled_for_repositories": false,
  "dependency_graph_enabled_for_new_repositories": false,
  "dependabot_alerts_enabled_for_new_repositories": false,
  "dependabot_security_updates_enabled_for_new_repositories": false,
  "advanced_security_enabled_for_new_repositories": false,
  "secret_scanning_enabled_for_new_repositories": false,
  "secret_scanning_push_protection_enabled_for_new_repositories": false,
  "secret_scanning_push_protection_custom_link": "https://github.com/octo-org/octo-repo/blob/main/im-blocked.md",
  "secret_scanning_push_protection_custom_link_enabled": false
}

Request

Response

Errors