---
title: "List Users on Team"
method: GET
path: "/v1/teams/{id}/users"
tags: ["Teams"]
---

# List Users on Team

`GET /v1/teams/{id}/users`

Retrieves basic information about users on a specified team. With user permissions, the authenticated user must have access to the team. With admin permissions, users from any team belonging to the account can be retrieved.

This endpoint is paginated.

## Path parameters

- `id` number, required

## Headers

- `Lucid-Request-As` string

## Response `200`

OK. Returns a list of Profile resources containing basic information about users on the specified team. If requesting as admin, Profile resources may be returned even if the authenticated user does not have direct access to the specified team.

- Profile[]
  - `accountId` number — The unique ID for the user's account.
  - `username` string — Username of the user.
  - `email` string — Email of the user.
  - `fullName` string — Full name of the user.
  - `id` number — ID of the user.
  - `avatar` Avatar — A reference to a user's avatar image. When the user has no uploaded avatar, this falls back to their Gravatar image.
    - `type` 'url', required — The kind of avatar. Currently always `url`, indicating the avatar is referenced by a link. Additional avatar kinds may be introduced in the future.
    - `link` string, required — A URL pointing to the user's avatar image.

## Other responses

- `403` — Forbidden. * if the user making the request does not have access to the specified team. * if the team has been archived, is not directly accessible by the authenticated user, or does not exist.

---

[API](https://skmtc.net/lucid/apis/lucid-rest-api.md) · [All operations](https://skmtc.net/lucid/apis/lucid-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lucid/lucid-rest-api/revisions/6a32cb9e1aa7/schema)