> ## Documentation Index
> Fetch the complete documentation index at: https://dronebundle.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# List Team Members

> List all team members in your workspace.

Requires an API key with `read_only` or `full_access` scope.

Returns a paginated list of team members. Results are returned in pages of up to 50 members.

## Query parameters

<ParamField query="role" type="string">
  Filter by role. One of: `root`, `project_manager`, `ops_lead`, `pilot`, `client`, `all`. Defaults to all members.
</ParamField>

<ParamField query="cursor" type="string">
  Pagination cursor from a previous response. Omit for the first page.
</ParamField>

## Response

<ResponseField name="team" type="object[]">
  Array of team member objects.

  <Expandable title="team member object">
    <ResponseField name="id" type="string">
      User ID.
    </ResponseField>

    <ResponseField name="email" type="string">
      Email address.
    </ResponseField>

    <ResponseField name="first_name" type="string | null">
      First name.
    </ResponseField>

    <ResponseField name="last_name" type="string | null">
      Last name.
    </ResponseField>

    <ResponseField name="role" type="string">
      Workspace role (`root`, `project_manager`, `ops_lead`, `pilot`, `client`).
    </ResponseField>

    <ResponseField name="status" type="string">
      Membership status (e.g. `active`).
    </ResponseField>

    <ResponseField name="title" type="string | null">
      Job title.
    </ResponseField>

    <ResponseField name="phone_number" type="string | null">
      Phone number.
    </ResponseField>

    <ResponseField name="profile_picture" type="string | null">
      Profile picture URL.
    </ResponseField>

    <ResponseField name="created" type="number">
      Unix timestamp (milliseconds) when the member was added.
    </ResponseField>

    <ResponseField name="updated" type="number">
      Unix timestamp (milliseconds) when the member was last updated.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="count" type="number">
  Number of members in the current page.
</ResponseField>

<ResponseField name="cursor" type="string | null">
  Cursor for the next page. `null` when there are no more results.
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api.dronebundle.com/v1/team?role=pilot" \
    -H "Authorization: Bearer v1_your_api_key_here"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "team": [
      {
        "id": "03144892-6021-705a-08f2-8e147cff3f28",
        "email": "john@example.com",
        "first_name": "John",
        "last_name": "Smith",
        "role": "pilot",
        "status": "active",
        "title": "Senior Pilot",
        "phone_number": "+45 12345678",
        "profile_picture": null,
        "created": 1743400000000,
        "updated": 1743400000000
      }
    ],
    "count": 1,
    "cursor": null
  }
  ```
</ResponseExample>