Get members who belong to an organization

List organization members. This endpoint is subject to eventual consistency. New users may not be immediately included in the response and deleted users may not be immediately removed from it.

• Use the fields parameter to optionally define the specific member details retrieved. If fields is left blank, all fields (except roles) are returned.
• Member roles are not sent by default. Use fields=roles to retrieve the roles assigned to each listed member. To use this parameter, you must include the read:organization_member_roles scope in the token.

This endpoint supports two types of pagination:

• Offset pagination
• Checkpoint pagination

Checkpoint pagination must be used if you need to retrieve more than 1000 organization members.

Checkpoint Pagination

To search by checkpoint, use the following parameters: - from: Optional id from which to start selection. - take: The total amount of entries to retrieve when using the from parameter. Defaults to 50. Note: The first time you call this endpoint using Checkpoint Pagination, you should omit the from parameter. If there are more results, a next value will be included in the response. You can use this for subsequent API calls. When next is no longer included in the response, this indicates there are no more pages remaining.

GET https://{tenantDomain}/api/v2/organizations/{id}/members

C#

C#

using Auth0.ManagementApi;
using System.Threading.Tasks;
using Auth0.ManagementApi.Organizations;

public partial class Examples
{
    public async Task Example() {
        var client = new ManagementClient(
            token: "<token>"
        );

        await client.Organizations.Members.ListAsync(
            id: "id",
            request: new ListOrganizationMembersRequestParameters {
                From = "from",
                Take = 1,
                Fields = "fields",
                IncludeFields = true
            }
        );
    }

}

200

[
  {
    "user_id": "<string>",
    "picture": "<string>",
    "name": "<string>",
    "email": "[e-mail]",
    "roles": [
      {
        "id": "<string>",
        "name": "<string>"
      }
    ]
  }
]

Autorisations

bearerAuthoAuth2ClientCredentials

Authorization · string · header · requis

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Paramètres de chemin

id · string · requis

Organization identifier.

Maximum string length: 50

Paramètres de requête

page · integer

Page index of the results to return. First page is 0.

Plage requise: 0 <= x <= 1000

per_page · integer

Number of results per page. Defaults to 50.

Plage requise: 1 <= x <= 100

include_totals · boolean

Return results inside an object that contains the total result count (true) or as a direct array of results (false, default).

from · string

Optional Id from which to start selection.

take · integer

Number of results per page. Defaults to 50.

Plage requise: 1 <= x <= 100

fields · string

Comma-separated list of fields to include or exclude (based on value provided for include_fields) in the result. Leave empty to retrieve all fields.

include_fields · boolean

Whether specified fields are to be included (true) or excluded (false).

Réponse

200

application/json

Members successfully retrieved.

Option 1 · object[]

Option 2 · object

Option 3 · object

user_id · string

ID of this user.

picture · string

URL to a picture for this user.

name · string

Name of this user.

email · string<email> · défaut: [e-mail]

Email address of this user.

roles · object[]

Show child attributes