---
title: "Get user's teams"
method: GET
path: "/v2/teams"
---

# Get user's teams

`GET /v2/teams`

## Request

- Base URL: `https://api.signnow.com`
- URL: `https://api.signnow.com/v2/teams`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/signnow/apis/signnow-api/docs/v2/teams/get.ts> (a function with typed inputs; its response is checked against the schema)

This endpoint allows API users to get the list of teams the user belongs to.

## Response `200`

List of teams the user belongs to.

- object
  - `data` object[]: List of teams.
    - `id` string: ID of the team.
    - `name` string: Name of the team.
    - `role` string: User's role in the team: `admin` or `member`.
    - `type` string: Team type: `VIEWABLE` or `SHAREABLE`.
    - `active` integer: Whether the team is active: `1` for active, `0` for inactive.
    - `created` integer: Unix timestamp of when the team was created.
    - `workspace_id` string: ID of the workspace the team belongs to. `null` if the team is not linked to a workspace.
  - `meta` object: Pagination details.
    - `pagination` object: Pagination information for the result set.
      - `count` integer: Number of items on the current page.
      - `links` object[]: Pagination links. Returned as an empty array when there are no further pages, and as an object with a `next` link otherwise.
      - `total` integer: Total number of items.
      - `per_page` integer: Maximum number of items per page.
      - `total_pages` integer: Total number of pages.
      - `current_page` integer: Number of the current page.

## Other responses

- `400`: * Wrong, expired, or missing token.

---

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