> ## Documentation Index
> Fetch the complete documentation index at: https://docs.craftflow.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Teams

> Retrieve a paginated list of teams in your company.



## OpenAPI

````yaml /api/openapi.json get /teams/
openapi: 3.1.0
info:
  title: Craft API
  description: Public API for programmatic access to your Craft data.
  version: 1.0.0
servers:
  - url: https://data.craftflow.co/api/v1
    description: Production
security:
  - bearerAuth: []
paths:
  /teams/:
    get:
      tags:
        - Teams
      summary: List Teams
      description: Retrieve a paginated list of teams in your company.
      operationId: listTeams
      parameters:
        - name: ordering
          in: query
          description: Sort results by a field. Prefix with `-` for descending order.
          required: false
          schema:
            type: string
            enum:
              - created_at
              - '-created_at'
            default: '-created_at'
        - name: page
          in: query
          description: Page number.
          required: false
          schema:
            type: integer
            default: 1
            minimum: 1
        - name: page_size
          in: query
          description: Number of results per page.
          required: false
          schema:
            type: integer
            default: 25
            minimum: 1
            maximum: 100
      responses:
        '200':
          description: A paginated list of teams.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/Team'
                  pagination:
                    $ref: '#/components/schemas/Pagination'
                required:
                  - data
                  - pagination
              example:
                data:
                  - id: c3d4e5f6-a7b8-9012-cdef-123456789012
                    name: Sales
                    description: Field sales team
                    created_at: '2025-03-01T10:00:00Z'
                  - id: d4e5f6a7-b8c9-0123-defa-234567890123
                    name: Support
                    description: Customer support team
                    created_at: '2025-04-15T12:00:00Z'
                pagination:
                  count: 2
                  page: 1
                  page_size: 25
                  total_pages: 1
        '401':
          description: Missing or invalid API key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Rate limit exceeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    Team:
      type: object
      properties:
        id:
          type: string
          format: uuid
          description: Unique identifier for the team.
        name:
          type: string
          description: The team's name.
        description:
          type: string
          description: A description of the team.
        created_at:
          type: string
          format: date-time
          description: When the team was created (ISO 8601).
      required:
        - id
        - name
        - description
        - created_at
    Pagination:
      type: object
      properties:
        count:
          type: integer
          description: Total number of results across all pages.
        page:
          type: integer
          description: Current page number.
        page_size:
          type: integer
          description: Number of results on this page.
        total_pages:
          type: integer
          description: Total number of pages.
      required:
        - count
        - page
        - page_size
        - total_pages
    Error:
      type: object
      properties:
        error:
          type: object
          properties:
            detail:
              type: string
              description: Human-readable error message.
          required:
            - detail
      required:
        - error
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Your API key, prefixed with `cf_live_`.

````