List org members Run in API Explorer

GET /v2/orgs/{org_name}/members
Bearer auth

Returns a list of members for an organization.

The following fields are only visible to orgs with insights enabled.

  • last_logged_in_at
  • last_seen_at
  • last_desktop_version

To make visible, please see View Insights for organization users.

Path parameters

  • org_name string Required

    Name of the organization (namespace).

Query parameters

  • page integer

    Page number (starts on 1).

  • page_size integer

    Number of items (rows) per page.

  • invites boolean

    Include invites in the response.

  • type string

    Values are all, invitee, or member.

  • role string

    Values are owner, editor, or member.

Responses

  • 200 application/json

    List of members

    Hide response attributes Show response attributes object
    • count number

      The total number of items that match with the search.

    • previous string

      The URL or link for the previous page of items.

    • next string

      The URL or link for the next page of items.

    • results array[object]

      List of accounts.

      Hide results attributes Show results attributes object
      • email string

        User's email address

      • role string

        User's role in the Organization

        Values are Owner, Member, or Invitee.

      • groups array[string]

        Groups (Teams) that the user is member of

      • is_guest boolean

        If the organization has verfied domains, members that have email addresses outside of those domains will be flagged as guests.

      • primary_email string Deprecated

        The user's email primary address.

      • last_logged_in_at string(date-time)

        Last time the user logged in. To access this field, you must have insights visible for your organization. See Insights.

      • last_seen_at string(date-time)

        Last time the user was seen. To access this field, you must have insights visible for your organization. See Insights.

      • last_desktop_version string

        Last desktop version the user used. To access this field, you must have insights visible for your organization. See Insights.

      • id string

        The UUID trimmed

      • company string
      • date_joined string
      • full_name string
      • gravatar_email string
      • gravatar_url string
      • location string
      • profile_url string
      • type string

        Values are User or Org.

      • username string
  • 400 application/json

    Bad Request

    Hide response attributes Show response attributes object
    • errinfo object
    • detail string
    • message string
  • 401 application/json

    Authentication failed

    Hide response attributes Show response attributes object
    • errinfo object
    • detail string
    • message string
  • 403 application/json

    Forbidden

    Hide response attributes Show response attributes object
    • errinfo object
    • detail string
    • message string
  • 404 application/json

    Not Found

    Hide response attributes Show response attributes object
    • errinfo object
    • detail string
    • message string
GET /v2/orgs/{org_name}/members 
curl \
 --request GET 'https://hub.docker.com/v2/orgs/myorganization/members' \
 --header "Authorization: Bearer $ACCESS_TOKEN"
Response examples (200) 
[
  {
    "count": 120,
    "previous": "https://hub.docker.com/v2/some/resources/items?page=1&page_size=20",
    "next": "https://hub.docker.com/v2/some/resources/items?page=3&page_size=20",
    "results": [
      {
        "email": "example@docker.com",
        "role": "Owner",
        "groups": [
          "developers",
          "owners"
        ],
        "is_guest": false,
        "primary_email": "example@docker.com",
        "last_logged_in_at": "2021-01-05T21:06:53.506400Z",
        "last_seen_at": "2021-01-05T21:06:53.506400Z",
        "last_desktop_version": "4.29.0",
        "id": "0ab70deb065a43fcacd55d48caa945d8",
        "company": "Docker Inc",
        "date_joined": "2021-01-05T21:06:53.506400Z",
        "full_name": "Jon Snow",
        "gravatar_email": "string",
        "gravatar_url": "string",
        "location": "string",
        "profile_url": "string",
        "type": "User",
        "username": "dockeruser"
      }
    ]
  }
]
Response examples (400) 
{
  "errinfo": {},
  "detail": "string",
  "message": "string"
}
Response examples (401) 
{
  "errinfo": {},
  "detail": "string",
  "message": "string"
}
Response examples (403) 
{
  "errinfo": {},
  "detail": "string",
  "message": "string"
}
Response examples (404) 
{
  "errinfo": {},
  "detail": "string",
  "message": "string"
}