Members List v2

POST

https://api.dropboxapi.com/2/team/members/list_v2

POST

/2/team/members/list_v2

import requests
url = "https://api.dropboxapi.com/2/team/members/list_v2"
payload = {
    "include_removed": False,
    "limit": 100
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())

Response headers

HTTP/1.1 200 OK
X-Dropbox-Request-Id: string

{
  "cursor": "ZtkX9_EHj3x7PMkVuFIhwKYXEpwpLwyxp9vMKomUhllil9q7eWiAu",
  "has_more": true,
  "members": [
    {
      "profile": {
        "email": "tami@seagull.com",
        "email_verified": false,
        "groups": [
          "g:e2db7665347abcd600000000001a2b3c"
        ],
        "member_folder_id": "20",
        "membership_type": {
          ".tag": "full"
        },
        "name": {
          "abbreviated_name": "FF",
          "display_name": "Franz Ferdinand (Personal)",
          "familiar_name": "Franz",
          "given_name": "Franz",
          "surname": "Ferdinand"
        },
        "root_folder_id": "30",
        "status": {
          ".tag": "active"
        },
        "team_member_id": "dbmid:FDFSVF-DFSDF",
        "account_id": "dbid:AAH4f99T0taONIb-OurWxbNQ6ywGRopQngc",
        "external_id": "244423",
        "joined_on": "2015-05-12T15:50:38Z",
        "profile_photo_url": "https://dl-web.dropbox.com/account_photo/get/dbaphid%3AAAHWGmIXV3sUuOmBfTz0wPsiqHUpBWvv3ZA?vers=1556069330102&size=128x128",
        "secondary_emails": [
          {
            "email": "grape@strawberry.com",
            "is_verified": false
          },
          {
            "email": "apple@orange.com",
            "is_verified": true
          }
        ]
      },
      "roles": [
        {
          "description": "Add, remove, and manage member accounts.",
          "name": "User management admin",
          "role_id": "pid_dbtmr:3456"
        }
      ]
    }
  ]
}

Lists members of a team.

Permission : Team information.

Required scope: members.read

Endpoint format: RPC

Authentication: Team

Authentication

AuthorizationBearer

Team-level OAuth 2.0 token issued to a Dropbox Business admin. Use Authorization: Bearer <token>.

Obtain via the authorization code flow with team-scoped permissions.

Grants access to team-wide administrative operations.

You can generate a short-lived access token from the App Console; see Testing with a generated token.

Request

This endpoint expects a nullable object.

include_removedbooleanOptionalDefaults to false

Whether to return removed members.

limituintOptional1-1000Defaults to 1000

Number of results to return per call.

Response headers

X-Dropbox-Request-IdstringOptional

A unique identifier for the request, useful for debugging and support.

Response

Successful response

cursorstring

Pass the cursor into members/list/continue:2 to obtain the additional members.

has_moreboolean

Is true if there are additional team members that have not been returned yet. An additional call to members/list/continue:2 can retrieve them.

memberslist of objects

List of team members.

Errors

401

Unauthorized Error

403

Forbidden Error

409

Conflict Error

429

Too Many Requests Error

500

Internal Server Error