---
title: "Search Teams"
method: GET
path: "/api/v2/teams"
tags: ["Teams V2"]
---

# Search Teams

`GET /api/v2/teams`

## Request

- Base URL: `https://public-api.linearb.io`
- URL: `https://public-api.linearb.io/api/v2/teams`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/linearb/apis/linearb-api/docs/api/v2/teams/get.ts> (a function with typed inputs; its response is checked against the schema)

Teams V2 API endpoint performs a LinearB teams paginated search

## Query parameters

- `offset` integer
- `page_size` integer
- `search_term` string
- `nonmerged_members_only` boolean

## Response `200`

Successful Response

- TeamsV2PaginatedResponseModel: A paginated response model specifically for Teams V2 API. This model represents a paginated response containing a list of teams and their total count. It is specifically designed for the Teams V2 API endpoints to provide consistent pagination structure across team-related responses. Attributes: total (int): The total number of teams available across all pages. This count represents the complete dataset size, not just the current page. items (List[TeamV2Model]): The list of teams in the current page.
  - `total` integer, required
  - `items` TeamV2Model[], required
    - `color` string: The team's color in hex format
    - `created_at` string, required: The timestamp when the team was created
    - `deleted_at` string: The timestamp when the team was deleted, if applicable
    - `established_at` string: The timestamp when the team was established
    - `extra` object: Additional custom information about the team
    - `id` integer, required: The unique identifier of the team
    - `initials` string: The team's initials (1-3 characters)
    - `name` string, required: The name of the team
    - `organization_id` integer, required: The ID of the organization this team belongs to
    - `parent_id` integer: The ID of the parent team, if this team is a sub-team
    - `updated_at` string: The timestamp when the team was last updated
    - `contributors` unknown

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `405`: Method Not Allowed
- `409`: Conflict
- `422`: Validation Error
- `500`: Internal Server Error
- `504`: Gateway Timeout

---

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