---
title: "List organization teams"
method: POST
path: "/v1/organizations/{organizationId}/teams/list"
tags: ["Organization"]
---

# List organization teams

`POST /v1/organizations/{organizationId}/teams/list`

## Request

- Base URL: `https://api.timesheet.io`
- URL: `https://api.timesheet.io/v1/organizations/{organizationId}/teams/list`
- Auth: one of:
  - HTTP bearer
  - API key in header `Authorization`

Retrieves a paginated list of every team in a specific organization, including teams the caller is not a member of. Supports sorting by name ('alpha') or creation date ('created'), ascending or descending, and searching by team name. A limit of -1 returns all teams. Only organization administrators can call this endpoint. Each team's permission reflects the caller's own team membership and is empty for teams the caller does not belong to.

## Path parameters

- `organizationId` string, required

## Request body

- TeamListParams
  - `search` string
  - `sort` string
  - `order` string
  - `count` integer
  - `page` integer
  - `limit` integer
  - `organizationId` string
  - `offset` integer

## Response `200`

List of teams

- TeamList
  - `items` TeamDto[]
    - `id` string
    - `organization` OrganizationDto
      - `id` string
      - `name` string
      - `description` string
      - `image` string
      - `color` integer
      - `subscription` CustomerSubscriptionDto
        - `id` string
        - `user` string
        - `expires` integer
        - `status` integer
        - `plan` integer
        - `licenses` integer
        - `scheduledPlan` integer
        - `scheduledLicenses` integer
        - `scheduledDate` integer
        - `paymentOption` string
        - `business` string
        - `email` string
        - `firstname` string
        - `lastname` string
        - `vatId` string
        - `displayName` string
        - `street` string
        - `city` string
        - `state` string
        - `zip` string
        - `country` string
        - `countryIso` string
        - `language` string
        - `includeTaxForBusiness` boolean
        - `activated` boolean
        - `pastDue` boolean
        - `cancellationOffer` boolean
        - `subscriptionActive` boolean
        - `subscriptionCancelled` boolean
        - `subscriptionInactive` boolean
        - `paymentProviderActive` boolean
        - `startedTestimonial` string, date-time
        - `activationDate` string, date-time
        - `cancellationDate` string, date-time
        - `permissionAdmin` boolean
        - `activatedTeams` boolean
        - `valid` boolean
        - `expired` boolean
        - `validAndActivated` boolean
        - `payPalPayment` boolean
        - `stripePayment` boolean
        - `invoicePayment` boolean
        - `googlePlayPayment` boolean
        - `appleStorePayment` boolean
        - `currency` string
        - `businessCustomer` boolean
        - `euCustomer` boolean
        - `eu` boolean
        - `at` boolean
        - `ch` boolean
        - `uk` boolean
        - `product` string
        - `licenseQuantity` integer
        - `active` boolean
        - `trial` boolean
        - `cancelled` boolean
        - `member` boolean
        - `businessOrTrial` boolean
        - `pro` boolean
        - `planEnterprise` boolean
        - `planBusiness` boolean
        - `planPro` boolean
        - `planPlus` boolean
        - `planBasic` boolean
        - `monthlyPlan` boolean
        - `yearlyPlan` boolean
        - `organization` boolean
      - `user` string
      - `aiChatEnabled` boolean
      - `lastUpdate` integer
      - `created` integer
      - `deleted` boolean
      - `permission` OrganizationPermissionDto
        - `invoicing` boolean
        - `billing` boolean
        - `admin` boolean
    - `organizationId` string
    - `name` string
    - `description` string
    - `image` string
    - `color` integer
    - `projectSalaryVisibility` integer
    - `user` string
    - `lastUpdate` integer
    - `created` integer
    - `deleted` boolean
    - `permission` TeamPermissionDto
      - `role` string
      - `managerOrOwner` boolean
      - `owner` boolean
      - `manager` boolean
      - `member` boolean
    - `organizationAdmin` boolean
    - `projects` integer
    - `members` integer
    - `projectSalaryVisible` boolean
  - `params` TeamListParams
    - `search` string
    - `sort` string
    - `order` string
    - `count` integer
    - `page` integer
    - `limit` integer
    - `organizationId` string
    - `offset` integer

## Other responses

- `401`: Not authorized
- `403`: Invalid permission (e.g., not an organization admin)

## Changes

> 14 revisions in range; 1 not diffed.

- **2026-10-25** `4e2eb2ebe708`: 8 info
  - added the optional property `items/items/organization/subscription/activatedTeams` to the response with the `200` status (media type: application/json)
  - added the optional property `items/items/organization/subscription/activatedTeams` to the response with the `200` status (media type: application/xml)
  - added the optional property `items/items/organization/subscription/scheduledDate` to the response with the `200` status (media type: application/json)
  - added the optional property `items/items/organization/subscription/scheduledDate` to the response with the `200` status (media type: application/xml)
  - …4 more
- **2026-10-05** `8290cf15248f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/timesheet/apis/timesheet-api/changes/v1/organizations/:organizationId/teams/list/post.md)

---

[API](https://skmtc.dev/timesheet/apis/timesheet-api.md) - [All operations](https://skmtc.dev/timesheet/apis/timesheet-api/llms.txt) - [OpenAPI document](https://skmtc.dev/timesheet/apis/timesheet-api/revisions/2f6595c95dc4?raw)