---
title: "List teams"
method: GET
path: "/api/user/teams"
tags: ["Teams"]
---

# List teams

`GET /api/user/teams`

## Request

- Base URL: `https://demo.hitkeep.com`
- URL: `https://demo.hitkeep.com/api/user/teams`
- Auth: API key in cookie `hk_token`

Returns all teams for the authenticated user and the current active team.

## Response `200`

Team list

- TeamListResponse
  - `active_team_id` string, uuid
  - `recent_team_ids` string[]
  - `teams` Team[]
    - `created_at` string, date-time
    - `entitlements` TeamEntitlements
      - `allow_custom_branding` boolean
      - `allow_external_report_recipients` boolean: Whether scheduled reports may be sent to confirmed addresses outside the team.
      - `allow_sso` boolean
      - `max_retention_days` integer
      - `max_sites_per_team` integer
      - `max_team_members` integer
    - `id` string, uuid
    - `logo_url` string
    - `name` string
    - `plan` TeamPlan
      - `code` string
      - `name` string
      - `support_url` string
      - `upgrade_url` string
    - `role` string
    - `usage` TeamUsageSummary
      - `current_members` integer
      - `current_pending_invites` integer
      - `current_sites` integer

---

[API](https://skmtc.dev/hitkeep/apis/hitkeep-rest-api.md) · [All operations](https://skmtc.dev/hitkeep/apis/hitkeep-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/hitkeep/apis/hitkeep-rest-api/revisions/bb2df36ab2a4?raw)