---
title: "List users in your team"
method: GET
path: "/v1/team-management/users"
tags: ["Team"]
---

# List users in your team

`GET /v1/team-management/users`

Paginated list of all sub-accounts in the team. Requires admin role on the calling account.

## Query parameters

- `offset` integer
- `count` integer

## Response `200`

List users in your team

- TestingbotEntitiesTeamMemberList — Testingbot_Entities_TeamMemberList model
  - `data` TestingbotEntitiesTeamMember[], required — Team member accounts.
    - `id` integer, required — Unique numeric user ID. Also the path param for team endpoints (e.g. /users/:id) and the parent_id reference on team members.
    - `first_name` string, required — Given name on the account.
    - `last_name` string, required — Family name on the account.
    - `seconds` integer, required — Remaining test seconds (credit balance) on the account; -1 means unlimited (e.g. Live plans).
    - `last_login` string, date-time, required — ISO-8601 timestamp of the most recent dashboard login.
    - `plan` string, required — Subscription plan name (e.g. "Free Trial", "Live - 5 Sessions - Unlimited", "Automated Pro ..."). For a sub-account this is the team owner's plan.
    - `max_concurrent` integer, required — Maximum number of parallel VM-based sessions allowed by the plan. For a sub-account this is the team owner's cap.
    - `max_concurrent_mobile` integer, required — Maximum number of parallel physical device sessions allowed by the plan. For a sub-account this is the team owner's cap.
    - `company` string, required — Optional company name for billing.
    - `street` string, required — Billing address line.
    - `city` string, required — Billing city.
    - `country` string, required — Billing country.
    - `vat` string, required — VAT number (EU only).
    - `read_only` boolean, required — Whether this account has read-only access within the team.
    - `roles` string[], required — Roles held by the account: "admin" and/or "owner".
    - `current_vm_concurrency` integer, required — VM-based sessions this account is running right now.
    - `current_physical_concurrency` integer, required — Physical-device sessions this account is running right now.
  - `meta` TestingbotEntitiesMeta, required
    - `offset` integer, required — Number of items skipped from the start of the result set.
    - `count` integer, required — Items returned in this page (matches the requested `count` query param).
    - `total` integer, required — Total number of items available across all pages.

## Other responses

- `401` — Authentication required
- `403` — Caller is not a team admin

---

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