# List org members [API catalog](/reference/api/) · [Docker Hub overview](/reference/api/hub/latest/) · [Product manual](https://docs.docker.com/docker-hub/) · [OpenAPI specification](/reference/api/hub/latest.yaml) API version: 2-beta `GET /v2/orgs/{org_name}/members` 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](https://docs.docker.com/accounts/organization/insights/#view-insights-for-organization-users). This operation accepts bearer tokens issued from organization access tokens (OATs). The token must have the required resource access and scopes. ## Connection and access [API connection and authentication guidance](/reference/api/hub/latest/#authentication) Server: `https://hub.docker.com` Effective security: alternatives are OR; schemes within an alternative are AND. An empty array declares no HTTP authentication requirement. ```json [ { "bearerAuth": [] } ] ``` ## Example request Replace placeholders and provide the required credentials or request body. ```console curl \ --request GET \ --header "Authorization: Bearer ${TOKEN}" \ --header 'Accept: application/json' \ 'https://hub.docker.com/v2/orgs/myorganization/members?type=all&role=owner' ``` ## Parameters ### org_name Location: path. Required: yes. Name of the organization (namespace). ```json { "description": "Name of the organization (namespace).", "example": "myorganization", "in": "path", "name": "org_name", "pointer": "/paths/~1v2~1orgs~1{org_name}~1members/parameters/0", "required": true, "schema": { "type": "string" } } ``` ### search Location: query. Required: no. Search term. ```json { "description": "Search term.", "in": "query", "name": "search", "pointer": "/paths/~1v2~1orgs~1{org_name}~1members/parameters/1", "schema": { "type": "integer" } } ``` ### page Location: query. Required: no. Page number (starts on 1). ```json { "description": "Page number (starts on 1).", "in": "query", "name": "page", "pointer": "/paths/~1v2~1orgs~1{org_name}~1members/parameters/2", "schema": { "type": "integer" } } ``` ### page_size Location: query. Required: no. Number of items (rows) per page. ```json { "description": "Number of items (rows) per page.", "in": "query", "name": "page_size", "pointer": "/paths/~1v2~1orgs~1{org_name}~1members/parameters/3", "schema": { "type": "integer" } } ``` ### invites Location: query. Required: no. Include invites in the response. ```json { "description": "Include invites in the response.", "in": "query", "name": "invites", "pointer": "/paths/~1v2~1orgs~1{org_name}~1members/parameters/4", "schema": { "type": "boolean" } } ``` ### type Location: query. Required: no. Filter members by membership type. ```json { "description": "Filter members by membership type.", "example": "all", "in": "query", "name": "type", "pointer": "/paths/~1v2~1orgs~1{org_name}~1members/parameters/5", "schema": { "enum": [ "all", "invitee", "member" ], "type": "string" } } ``` ### role Location: query. Required: no. Filter members by their organization role. ```json { "description": "Filter members by their organization role.", "example": "owner", "in": "query", "name": "role", "pointer": "/paths/~1v2~1orgs~1{org_name}~1members/parameters/6", "schema": { "enum": [ "owner", "editor", "member" ], "type": "string" } } ``` ## Request and responses ### Response 200 application/json List of members Schema: ```json { "$ref": "#/components/schemas/org_member_paginated" } ``` Schema example: ```json { "count": 1, "next": null, "previous": null, "results": [ { "date_joined": "2021-01-05T21:06:53.506400Z", "email": "example@docker.com", "full_name": "Jon Snow", "groups": [ "owners" ], "id": "0ab70deb065a43fcacd55d48caa945d8", "is_guest": false, "role": "Owner", "type": "User", "username": "dockeruser" } ] } ``` ### Response 400 application/json Bad Request Schema: ```json { "$ref": "#/components/schemas/error" } ``` error: ```json { "errinfo": null, "message": "bad request" } ``` ### Response 401 application/json Unauthorized Schema: ```json { "$ref": "#/components/schemas/error" } ``` error: ```json { "errinfo": null, "message": "unauthorized" } ``` ### Response 403 application/json Forbidden Schema: ```json { "$ref": "#/components/schemas/error" } ``` error: ```json { "errinfo": null, "message": "permission denied" } ``` ### Response 404 application/json Not Found Schema: ```json { "$ref": "#/components/schemas/error" } ``` error: ```json { "errinfo": null, "message": "not found" } ``` ## Complete operation contract ```json { "description": "Returns a list of members for an organization.\n\n_The following fields are only visible to orgs with insights enabled._\n\n- `last_logged_in_at`\n- `last_seen_at`\n- `last_desktop_version`\n\nTo make visible, please see [View Insights for organization users](https://docs.docker.com/accounts/organization/insights/#view-insights-for-organization-users).\n\nThis operation accepts bearer tokens issued from organization access tokens (OATs). The token must have the required resource access and scopes.\n", "operationId": "getV2OrgsByOrgNameMembers", "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/org_member_paginated" } } }, "description": "List of members" }, "400": { "$ref": "#/components/responses/bad_request" }, "401": { "$ref": "#/components/responses/unauthorized" }, "403": { "$ref": "#/components/responses/forbidden" }, "404": { "$ref": "#/components/responses/not_found" } }, "security": [ { "bearerAuth": [] } ], "summary": "List org members", "tags": [ "orgs" ] } ``` ## Referenced schemas - `#/components/responses/bad_request` - `#/components/responses/forbidden` - `#/components/responses/not_found` - `#/components/responses/unauthorized` - [#/components/schemas/org_member_paginated](/reference/api/hub/latest/schemas/org_member_paginated/)