---
title: "Get teams on a project"
method: GET
path: "/projects/{id}/teams"
tags: ["sharing"]
---

# Get teams on a project

`GET /projects/{id}/teams`

Returns a project with all teams which have access on a given project.

## Path parameters

- `id` integer, required

## Query parameters

- `page` integer
- `per_page` integer
- `s` string

## Response `200`

The teams with their permission.

- ModelsTeamWithPermission[]
  - `created` string — A timestamp when this relation was created. You cannot change this value.
  - `created_by` UserUser
    - `bot_owner_id` integer — BotOwnerID is the ID of the owning (human) user if this user is a bot. A non-zero value means this user is a bot and cannot authenticate via password.
    - `created` string — A timestamp when this task was created. You cannot change this value.
    - `email` string — The user's email address.
    - `id` integer — The unique, numeric id of this user.
    - `name` string — The full name of the user.
    - `updated` string — A timestamp when this task was last updated. You cannot change this value.
    - `username` string — The username of the user. Is always unique.
  - `description` string — The team's description.
  - `external_id` string — The team's external id provided by the openid or ldap provider
  - `id` integer — The unique, numeric id of this team.
  - `is_public` boolean — Defines wether the team should be publicly discoverable when sharing a project
  - `members` ModelsTeamUser[] — An array of all members in this team.
    - `admin` boolean — Whether the member is an admin of the team. See the docs for more about what a team admin can do
    - `bot_owner_id` integer — BotOwnerID is the ID of the owning (human) user if this user is a bot. A non-zero value means this user is a bot and cannot authenticate via password.
    - `created` string — A timestamp when this task was created. You cannot change this value.
    - `email` string — The user's email address.
    - `id` integer — The unique, numeric id of this user.
    - `name` string — The full name of the user.
    - `updated` string — A timestamp when this task was last updated. You cannot change this value.
    - `username` string — The username of the user. Is always unique.
  - `name` string — The name of this team.
  - `permission` 0 | 1 | 2
  - `updated` string — A timestamp when this relation was last updated. You cannot change this value.

## Other responses

- `403` — No permission to see the project.
- `500` — Internal error

---

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