---
title: "Retrieve user details"
method: GET
path: "/v2/team/users-details"
tags: ["team"]
---

# Retrieve user details

`GET /v2/team/users-details`

Retrieve user details based on the provided team ID. The endpoint returns information such as user ID, email, first name, and last name for all users in the team. You can also fetch detail of a single user. To fetch details for an individual user, include their user ID to limit the response to that specific user.

## Query parameters

- `teamId` string, required
- `retailerTeamId` string
- `offset` string
- `limit` string
- `userId` string

## Response `200`

The team object for requested id.

- V2GetUsersForTeamResponse
  - `users` V2Users[]
    - `id` string — The unique identifier of the user.
    - `email` string — The email address of the user.
    - `namespace` string — The domain or namespace associated with the user's organization.
    - `firstName` string — The first name of the user.
    - `lastName` string — The last name of the user.
    - `logoId` string — The Id of user's profile picture or logo.
    - `roleIds` Authv2RoleTypes[] — The team permissions. Users can be assigned either retailer or supplier permissions: - Retailer full: Provides users full access, allowing them to modify administration settings, campaigns, reviews, team manager roles, and team settings. - Retailer report view: Provides users with read only access to dashboards, campaigns, and reporting data. - Supplier full: Provides users full access, allowing them to modify administration settings, campaigns, and team settings. - Supplier report view: Provides users with read only access to dashboards, campaigns, and reporting data.

## Other responses

- `400` — There was a problem with input.
- `401` — Access denied due to insufficient permissions.
- `403` — Login failed or token not valid.
- `404` — Team for specified id does not exist.
- `default` — An unexpected error response.

---

[API](https://skmtc.net/citrusad/apis/citrus-auth-api.md) · [All operations](https://skmtc.net/citrusad/apis/citrus-auth-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/citrusad/citrus-auth-api/revisions/a040003c7378/schema)