---
title: "List teams"
url: "https://nov18-dev.movespot.fyi/apis/internal-pdp-auth-admin-api-v1-1/versions/65945f7f-ee1f-40d6-be36-704dd7f85fcb/operations/listTeams"
---

> Full API specification: https://nov18-dev.movespot.fyi/apis/internal-pdp-auth-admin-api-v1-1/versions/65945f7f-ee1f-40d6-be36-704dd7f85fcb.md

# List teams

`GET` `/teams`

Operation ID: `listTeams`

Returns a paginated list of all teams

## Responses

- `200` - Successful response

## OpenAPI definition

```yaml
openapi: 3.0.3
info:
  title: Internal PDP Auth Admin API v1
  version: 1.0.0
servers:
  - url: http://authorization-admin-api.kauth.svc.cluster.local:8000/v1
    description: Konnect cluster
paths:
  /teams:
    get:
      operationId: listTeams
      summary: List teams
      description: Returns a paginated list of all teams
      responses:
        "200":
          description: Successful response
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TeamsResponse"
      tags:
        - Teams
components:
  schemas:
    TeamsResponse:
      type: object
      properties:
        meta:
          $ref: "#/components/schemas/PaginatedMeta"
        data:
          type: array
          items:
            $ref: "#/components/schemas/Team"
      required:
        - meta
        - data
    PaginatedMeta:
      description: returns the pagination information
      type: object
      properties:
        page:
          $ref: "#/components/schemas/PageMeta"
      required:
        - page
      title: PaginatedMeta
    Team:
      description: A team that can be assigned roles
      type: object
      properties:
        id:
          description: Unique identifier of the team
          type: string
        domain:
          description: Domain the team is associated with
          type: string
        name:
          description: Name of the team
          type: string
        display_name:
          description: Display name of the team
          type: string
        description:
          description: Description of the team
          type: string
        feature_flag:
          description: Optional feature flag which guards the team
          type: string
          nullable: true
        roles:
          description: List of roles assigned to the team
          type: array
          items:
            type: string
      required:
        - id
        - domain
        - name
        - display_name
        - description
        - feature_flag
        - roles
    PageMeta:
      description: Contains pagination query parameters and the total number of
        objects returned.
      type: object
      properties:
        number:
          type: number
          example: 1
        size:
          type: number
          example: 10
        total:
          type: number
          example: 100
      required:
        - number
        - size
        - total
```
