---
title: "Gets a list of Teams."
method: GET
path: "/Teams"
tags: ["Teams"]
---

# Gets a list of Teams.

`GET /Teams`

## Request

- Base URL: `https://api.insightly.com/v3.1`
- URL: `https://api.insightly.com/v3.1/Teams`
- Auth: none declared. Required headers: `Authorization`

Simple object graphs (excluding TEAMMEMBERS) are returned if "brief=true" is used in the query string.            <br /> The API responses may contain two types of Teams: a) regular Teams configured via System Settings and b) so called Anonymous Teams which are created by the system when you set a record permission visible to Individuals.            You can differentiate these two types on Teams by the ANONYMOUS_TEAM property. Anonymous Teams are a bit more restricted when it comes to modifying them via the API, they can only be created/updated/deleted via the root /Teams endpoint.

## Query parameters

- `brief` boolean
- `skip` integer
- `top` integer
- `count_total` boolean

## Headers

- `Authorization` string, required

## Response `200`

Request succeeded.

- object[]
  - `TEAM_ID` integer
  - `TEAM_NAME` string
  - `DATE_CREATED_UTC` string, date-time
  - `DATE_UPDATED_UTC` string, date-time
  - `TEAMMEMBERS` APITeamMember[]
    - `PERMISSION_ID` integer
    - `TEAM_ID` integer
    - `MEMBER_USER_ID` integer, required

## Other responses

- `400`: Often missing or invalid parameter.
- `401`: Invalid api key provided.

---

[API](https://skmtc.dev/insightly/apis/insightly-api-v3-1.md) - [All operations](https://skmtc.dev/insightly/apis/insightly-api-v3-1/llms.txt) - [OpenAPI document](https://skmtc.dev/insightly/apis/insightly-api-v3-1/revisions/e7df0c3b65fb?raw)