# Get an organization From **GitHub v3 REST API**. `GET /orgs/{org}` To see many of the organization response values, you need to be an authenticated organization owner with the `admin:org` scope. When the value of `two_factor_requirement_enabled` is `true`, the organization requires all members, billing managers, and outside collaborators to enable [two-factor authentication](https://docs.github.com/articles/securing-your-account-with-two-factor-authentication-2fa/). GitHub Apps with the `Organization plan` permission can use this endpoint to retrieve information about an organization's GitHub Enterprise Server plan. See "[Authenticating with GitHub Apps](https://docs.github.com/enterprise-server@3.0/apps/building-github-apps/authenticating-with-github-apps/)" for details. For an example response, see 'Response with GitHub Enterprise Server plan information' below." ## Parameters ### `org` - Location: path - Required: true - Type: `string` ## Responses ### `200` Response ### `application/json` - Type: `object` Organization Full ```json { "avatar_url": "https://github.com/images/error/octocat_happy.gif", "billing_email": "mona@github.com", "blog": "https://github.com/blog", "collaborators": 8, "company": "GitHub", "created_at": "2008-01-14T04:33:35Z", "default_repository_permission": "read", "description": "A great organization", "disk_usage": 10000, "email": "octocat@github.com", "events_url": "https://api.github.com/orgs/github/events", "followers": 20, "following": 0, "has_organization_projects": true, "has_repository_projects": true, "hooks_url": "https://api.github.com/orgs/github/hooks", "html_url": "https://github.com/octocat", "id": 1, "is_verified": true, "issues_url": "https://api.github.com/orgs/github/issues", "location": "San Francisco", "login": "github", "members_allowed_repository_creation_type": "all", "members_can_create_internal_repositories": false, "members_can_create_pages": true, "members_can_create_private_repositories": false, "members_can_create_public_repositories": false, "members_can_create_repositories": true, "members_can_fork_private_repositories": false, "members_url": "https://api.github.com/orgs/github/members{/member}", "name": "github", "node_id": "MDEyOk9yZ2FuaXphdGlvbjE=", "owned_private_repos": 100, "plan": { "filled_seats": 4, "name": "Medium", "private_repos": 20, "seats": 5, "space": 400 }, "private_gists": 81, "public_gists": 1, "public_members_url": "https://api.github.com/orgs/github/public_members{/member}", "public_repos": 2, "repos_url": "https://api.github.com/orgs/github/repos", "total_private_repos": 100, "twitter_username": "github", "two_factor_requirement_enabled": true, "type": "Organization", "updated_at": "2014-03-03T18:58:10Z", "url": "https://api.github.com/orgs/github" } ``` ```json {"description":"Organization Full","properties":{"avatar_url":{"example":"https://github.com/images/error/octocat_happy.gif","type":"string"},"billing_email":{"example":"org@example.com","format":"email","nullable":true,"type":"string"},"blog":{"example":"https://github.com/blog","format":"uri","type":"string"},"collaborators":{"example":8,"nullable":true,"type":"integer"},"company":{"example":"GitHub","type":"string"},"created_at":{"example":"2008-01-14T04:33:35Z","format":"date-time","type":"string"},"default_repository_permission":{"nullable":true,"type":"string"},"description":{"example":"A great organization","nullable":true,"type":"string"},"disk_usage":{"example":10000,"nullable":true,"type":"integer"},"email":{"example":"octocat@github.com","format":"email","type":"string"},"events_url":{"example":"https://api.github.com/orgs/github/events","format":"uri","type":"string"},"followers":{"example":20,"type":"integer"},"following":{"example":0,"type":"integer"},"has_organization_projects":{"example":true,"type":"boolean"},"has_repository_projects":{"example":true,"type":"boolean"},"hooks_url":{"example":"https://api.github.com/orgs/github/hooks","type":"string"},"html_url":{"example":"https://github.com/octocat","format":"uri","type":"string"},"id":{"example":1,"type":"integer"},"is_verified":{"example":true,"type":"boolean"},"issues_url":{"example":"https://api.github.com/orgs/github/issues","type":"string"},"location":{"example":"San Francisco","type":"string"},"login":{"example":"github","type":"string"},"members_allowed_repository_creation_type":{"example":"all","type":"string"},"members_can_create_internal_repositories":{"example":true,"type":"boolean"},"members_can_create_pages":{"example":true,"type":"boolean"},"members_can_create_private_pages":{"example":true,"type":"boolean"},"members_can_create_private_repositories":{"example":true,"type":"boolean"},"members_can_create_public_pages":{"example":true,"type":"boolean"},"members_can_create_public_repositories":{"example":true,"type":"boolean"},"members_can_create_repositories":{"example":true,"nullable":true,"type":"boolean"},"members_can_fork_private_repositories":{"example":false,"nullable":true,"type":"boolean"},"members_url":{"example":"https://api.github.com/orgs/github/members{/member}","type":"string"},"name":{"example":"github","type":"string"},"node_id":{"example":"MDEyOk9yZ2FuaXphdGlvbjE=","type":"string"},"owned_private_repos":{"example":100,"type":"integer"},"plan":{"properties":{"filled_seats":{"type":"integer"},"name":{"type":"string"},"private_repos":{"type":"integer"},"seats":{"type":"integer"},"space":{"type":"integer"}},"required":["name","space","private_repos"],"type":"object"},"private_gists":{"example":81,"nullable":true,"type":"integer"},"public_gists":{"example":1,"type":"integer"},"public_members_url":{"example":"https://api.github.com/orgs/github/public_members{/member}","type":"string"},"public_repos":{"example":2,"type":"integer"},"repos_url":{"example":"https://api.github.com/orgs/github/repos","format":"uri","type":"string"},"total_private_repos":{"example":100,"type":"integer"},"twitter_username":{"example":"github","nullable":true,"type":"string"},"two_factor_requirement_enabled":{"example":true,"nullable":true,"type":"boolean"},"type":{"example":"Organization","type":"string"},"updated_at":{"format":"date-time","type":"string"},"url":{"example":"https://api.github.com/orgs/github","format":"uri","type":"string"}},"required":["login","url","id","node_id","repos_url","events_url","hooks_url","issues_url","members_url","public_members_url","avatar_url","description","html_url","has_organization_projects","has_repository_projects","public_repos","public_gists","followers","following","type","created_at","updated_at"],"title":"Organization Full","type":"object"} ``` ### `404` Resource not found ### `application/json` - Type: `object` Basic Error ```json {"description":"Basic Error","properties":{"documentation_url":{"type":"string"},"message":{"type":"string"},"status":{"type":"string"},"url":{"type":"string"}},"title":"Basic Error","type":"object"} ``` ## Request examples ### cURL ```shell curl --request GET \ --url {protocol}://{hostname}/api/v3/orgs/{org} ```