Source: https://datafa.st/docs/api/account/team/list
Markdown source: https://datafa.st/docs/api/account/team/list.md
Description: List team members.

# List team members

`GET https://datafa.st/api/v1/admin/websites/{websiteId}/team`

List team members with their roles on the website. Roles control what each member can do in the dashboard and via the API.

Roles: `owner` (full access including team), `member` (manage settings), `viewer` (read-only).

> **Related:** [Team roles](/changelog/team-member-roles)

## Request

#### Path parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `websiteId` | string | — | Website ObjectId. From [List websites](/docs/api/account/websites/list) (`_id` field). Example: `665f0b3c4d2e1a0012345678`. |

## Response

Returns a JSON object with `status: "success"` and endpoint-specific fields in `data`.

#### Response fields

| Field | Type | Description |
| --- | --- | --- |
| `data[].userId` | string | Team member user ObjectId. |
| `data[].name` | string\|null | Human-readable name for the resource or event. The exact meaning depends on the endpoint. |
| `data[].email` | string | Team member email. |
| `data[].image` | string\|null | Profile image URL. |
| `data[].role` | string | `owner`, `member`, or `viewer`. |
| `data[].joinedAt` | string | Membership creation timestamp. |

### Authentication

Use a `dft_` account token with `team:read`.

A `df_` website API key for the same website can also call this route when the path `websiteId` matches the key's website. Write access with a `df_` key is capped at **member** level — owner-only actions such as [team management](/docs/api/account/team) require a `dft_` token and owner role.

### Errors

See [API errors](/docs/api#errors) for the standard error envelope, auth failures, validation errors, permission errors, and rate limits.

## Code examples

### Example request

```bash
curl -X GET "https://datafa.st/api/v1/admin/websites/{websiteId}/team" \
  -H "Authorization: Bearer dft_xxx"
```

### Success response

```json
{
  "status": "success",
  "data": [{
    "userId": "665f0b3c4d2e1a0012345678",
    "name": "Jane Doe",
    "email": "jane@example.com",
    "image": "https://example.com/avatar.png",
    "role": "owner",
    "joinedAt": "2026-05-21T00:00:00.000Z"
  }]
}
```