> ## Documentation Index > Fetch the complete documentation index at: https://developer.zeeg.me/llms.txt > Use this file to discover all available pages before exploring further. # List Teams > List the teams of your workspace with their member counts. List a team's members to get the id that removes one. ## OpenAPI ````yaml GET /teams openapi: 3.0.0 info: title: Zeeg Public API description: >- Zeeg public API documentation. ## Authentication All endpoints require a Bearer token. You can generate an API token from [your Zeeg dashboard](https://app.zeeg.me/account/settings/api-access). Each token is scoped to specific permissions (e.g. `events:read`, `webhooks:write`). Make sure your token has the required scopes for the endpoints you want to use. ## Responses Every response is JSON, whatever `Accept` header the request sends. version: 2.0.0 x-logo: url: https://app.zeeg.me/img/logo-dark.2ca83593.svg backgroundColor: '#f7f7f9' altText: zeeg contact: name: Zeeg Support email: support@zeeg.me url: https://zeeg.me/en/contact license: name: Proprietary url: https://zeeg.me/en/legal/terms termsOfService: https://zeeg.me/en/legal/terms servers: - url: https://api.zeeg.me/v2 description: Production security: - bearer: [] tags: - name: Scheduled Events description: Management of events scheduled via Zeeg - name: Scheduling Pages description: Scheduling pages information and management - name: Availability Schedule description: Read and change availability for users - name: Webhooks description: Webhooks management - name: Notes description: Notes for scheduled events - name: Workspaces & Teams description: Workspace users and team member management - name: AI Agent description: AI Agent integration endpoints - name: Payloads description: Webhook payload schemas - name: CRM - Objects description: >- Discover the schema of CRM objects (standard and custom) including all attribute definitions - name: CRM - Companies description: Create, read, update, and delete CRM company records - name: CRM - People description: Create, read, update, and delete CRM person records - name: Routing Forms - Forms description: Read routing forms with their questions and their routes - name: Routing Forms - Submissions description: Read and delete the submissions that invitees send through a routing form paths: /teams: get: tags: - Workspaces & Teams summary: List teams description: >- Returns a paginated list of the teams in your workspace, by title, each with its member and manager counts. Every member of the workspace sees every team, except an external member, who sees none. **Required scope:** `teams:read` or `teams:write` operationId: get-teams parameters: - schema: type: integer default: 1 minimum: 1 in: query name: page description: Page number. - name: count in: query schema: type: integer default: 20 minimum: 1 maximum: 100 description: Number of teams per page. responses: '200': description: OK content: application/json: schema: type: object properties: success: type: boolean example: true status: type: integer example: 200 data: type: object properties: pagination: $ref: '#/components/schemas/Pagination' teams: type: array items: $ref: '#/components/schemas/Team' examples: Success: value: success: true status: 200 data: pagination: totalItems: 1 perPage: 20 currentPage: 1 lastPage: 1 hasPreviousPage: false hasNextPage: false teams: - id: 73e4761b-5257-4e83-a807-974a3f2f3adc title: Customer Success slug: customer-success link: https://zeeg.me/customer-success country: DE timezone: Europe/Berlin welcomeMessage: null memberCount: 1 managerCount: 1 createdAt: '2026-04-10T09:00:00+00:00' updatedAt: '2026-04-10T09:00:00+00:00' '401': $ref: '#/components/responses/401' '403': $ref: '#/components/responses/403' security: - bearer: [] components: schemas: Pagination: type: object description: The page counters that a paginated list response carries. properties: totalItems: type: integer description: Number of items that match the request across every page. example: 42 perPage: type: integer description: Number of items on one page. example: 20 currentPage: type: integer description: Number of the page in this response. example: 1 lastPage: type: integer description: Number of the last page. example: 3 hasPreviousPage: type: boolean description: True when a page comes before this one. example: false hasNextPage: type: boolean description: True when a page comes after this one. example: true Team: type: object description: >- A team of the workspace with its member and manager counts. `GET /teams/{teamId}/members` lists the members. properties: id: type: string format: uuid example: 73e4761b-5257-4e83-a807-974a3f2f3adc title: type: string example: Customer Success slug: type: string description: >- The team's public page lives at `link`. Changing the slug changes that address, and links shared before stop working. example: customer-success link: type: string format: uri example: https://zeeg.me/customer-success country: type: string description: ISO 3166-1 alpha-2 country code. example: DE timezone: type: string example: Europe/Berlin welcomeMessage: type: string nullable: true example: Book a call with our customer success team. memberCount: type: integer description: >- Active members, managers included. `GET /teams/{teamId}/members` lists them. example: 5 managerCount: type: integer description: Active members with the role `manager`. example: 1 createdAt: type: string format: date-time updatedAt: type: string format: date-time responses: '401': description: Unauthorized content: application/json: schema: type: object properties: message: type: string example: Unauthenticated. examples: Unauthenticated: value: message: Unauthenticated. '403': description: Forbidden content: application/json: schema: type: object properties: error: type: object properties: type: type: string message: type: string error_id: type: string required_scopes: type: array items: type: string examples: Missing scope: value: error: type: insufficient_scope message: 'Your token is missing the required scope: crm:write.' error_id: a15b5b16-02c6-423b-be78-48627f4b80fe required_scopes: - crm:write securitySchemes: bearer: type: http scheme: bearer description: '' ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.