---
title: "List users that are assigned to an organization role"
method: GET
path: "/orgs/{org}/organization-roles/{role_id}/users"
tags: ["orgs"]
---

# List users that are assigned to an organization role

`GET /orgs/{org}/organization-roles/{role_id}/users`

Lists organization members that are assigned to an organization role. For more information on organization roles, see "[Using organization roles](https://docs.github.com/organizations/managing-peoples-access-to-your-organization-with-roles/using-organization-roles)."

To use this endpoint, you must be an administrator for the organization.

OAuth app tokens and personal access tokens (classic) need the `admin:org` scope to use this endpoint.

## Path parameters

- `org` string, required
- `role_id` integer, required

## Query parameters

- `per_page` integer
- `page` integer

## Response `200`

Response - List of assigned users

- UserRoleAssignment[] — List of users assigned to the organization role
  - `assignment` 'direct' | 'indirect' | 'mixed' — Determines if the user has a direct, indirect, or mixed relationship to a role
  - `inherited_from` TeamSimple[] — Team the user has gotten the role through
    - `id` integer, required — Unique identifier of the team
    - `node_id` string, required
    - `url` string, uri, required — URL for the team
    - `members_url` string, required
    - `name` string, required — Name of the team
    - `description` string, nullable, required — Description of the team
    - `permission` string, required — Permission that the team will have for its repositories
    - `privacy` string — The level of privacy this team should have
    - `notification_setting` string — The notification setting the team has set
    - `html_url` string, uri, required
    - `repositories_url` string, uri, required
    - `slug` string, required
    - `ldap_dn` string — Distinguished Name (DN) that team maps to within LDAP environment
    - `type` 'enterprise' | 'organization', required — The ownership type of the team
    - `organization_id` integer — Unique identifier of the organization to which this team belongs
    - `enterprise_id` integer — Unique identifier of the enterprise to which this team belongs
  - `name` string, nullable
  - `email` string, nullable
  - `login` string, required
  - `id` integer, required
  - `node_id` string, required
  - `avatar_url` string, uri, required
  - `gravatar_id` string, nullable, required
  - `url` string, uri, required
  - `html_url` string, uri, required
  - `followers_url` string, uri, required
  - `following_url` string, required
  - `gists_url` string, required
  - `starred_url` string, required
  - `subscriptions_url` string, uri, required
  - `organizations_url` string, uri, required
  - `repos_url` string, uri, required
  - `events_url` string, required
  - `received_events_url` string, uri, required
  - `type` string, required
  - `site_admin` boolean, required
  - `starred_at` string
  - `user_view_type` string

## Other responses

- `404` — Response if the organization or role does not exist.
- `422` — Response if the organization roles feature is not enabled or validation failed.

---

[API](https://skmtc.net/github/apis/api-github-com.md) · [All operations](https://skmtc.net/github/apis/api-github-com/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/github/api-github-com/revisions/a367f7028301/schema)