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

# List a pool's hosts and their limits

> Returns the rotating hosts of the pool's event types in user id order, each with their own limit and the limit enforced for them. Requires permission to update the team's event types, since a host's limit can reveal their overall booking limit. If accessed using an OAuth access token, the `TEAM_EVENT_TYPE_WRITE` scope is required.



## OpenAPI

````yaml /api-reference/v2/openapi.json get /v2/teams/{teamId}/booking-limit-pools/{poolId}/hosts
openapi: 3.0.0
info:
  title: Cal.com API v2
  description: ''
  version: 1.0.0
  contact: {}
servers: []
security: []
tags: []
paths:
  /v2/teams/{teamId}/booking-limit-pools/{poolId}/hosts:
    get:
      tags:
        - Teams / Booking limit pools
      summary: List a pool's hosts and their limits
      description: >-
        Returns the rotating hosts of the pool's event types in user id order,
        each with their own limit and the limit enforced for them. Requires
        permission to update the team's event types, since a host's limit can
        reveal their overall booking limit. If accessed using an OAuth access
        token, the `TEAM_EVENT_TYPE_WRITE` scope is required.
      operationId: TeamsBookingLimitPoolsController_listHosts
      parameters:
        - name: Authorization
          in: header
          description: >-
            value must be `Bearer <token>` where `<token>` is api key prefixed
            with cal_, managed user access token, or OAuth access token
          required: true
          schema:
            type: string
        - name: poolId
          required: true
          in: path
          description: Pool UUID; short UUID form is accepted too.
          schema:
            type: string
            format: uuid
        - name: cursor
          required: false
          in: query
          description: The `nextCursor` of the previous page.
          schema:
            format: uuid
            example: 0bce7b70-d7f0-4e5f-bcce-2f41b6fd5116
            type: string
        - name: take
          required: false
          in: query
          schema:
            minimum: 1
            maximum: 100
            default: 50
            type: number
        - name: teamId
          required: true
          in: path
          description: >-
            The team's uuid (preferred), its short-uuid (Flickr Base58) form, or
            its numeric id.
          schema:
            anyOf:
              - type: string
              - type: number
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BookingLimitPoolHostsOutput'
components:
  schemas:
    BookingLimitPoolHostsOutput:
      type: object
      properties:
        status:
          type: string
          enum:
            - success
        data:
          $ref: '#/components/schemas/BookingLimitPoolHostsData'
      required:
        - status
        - data
    BookingLimitPoolHostsData:
      type: object
      properties:
        hosts:
          type: array
          items:
            $ref: '#/components/schemas/BookingLimitPoolHostOutput'
        nextCursor:
          type: string
          nullable: true
          format: uuid
          description: Pass as `cursor` to fetch the next page; null on the last page.
      required:
        - hosts
        - nextCursor
    BookingLimitPoolHostOutput:
      type: object
      properties:
        userId:
          type: string
          format: uuid
        hostLimit:
          nullable: true
          description: >-
            The host's own limits; null while every interval uses the pool's
            limits.
          type: object
          allOf:
            - $ref: '#/components/schemas/BookingLimitsOutput'
        effectiveLimit:
          description: The limits enforced for this host.
          allOf:
            - $ref: '#/components/schemas/BookingLimitsOutput'
      required:
        - userId
        - hostLimit
        - effectiveLimit
    BookingLimitsOutput:
      type: object
      properties:
        perDay:
          type: number
          nullable: true
          example: 4
        perWeek:
          type: number
          nullable: true
          example: 20
        perMonth:
          type: number
          example: 60
          nullable: true
        perYear:
          type: number
          nullable: true
          example: 500
      required:
        - perDay
        - perWeek
        - perMonth
        - perYear

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.