> ## 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 an Event's co-hosts

> Returns the Event's co-hosts in their display order, with pending and declined invitations alongside accepted co-hosts.

Co-hosts are people invited by email to help run the Event without joining the owning team. Unlike hosts — the owner and the team members on the Event's host roster, who can do everything — an accepted co-host can view and edit the Event's details and manage its guests (invite, approve, check in), but cannot publish, cancel or delete the Event, change its pricing, or manage co-hosts. An invitation grants nothing until the invitee accepts it while signed in with the invited email address.

The authenticated user must be the Event's owner, one of its hosts, an accepted co-host, or a member of the owning team; an accepted co-host sees only the accepted co-hosts.

PBAC permission for team events: `calEvent.read`. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control.

If accessed using an OAuth access token, the `EVENT_READ` scope is required.



## OpenAPI

````yaml /api-reference/v2/openapi.json get /v2/events/{uuid}/co-hosts
openapi: 3.0.0
info:
  title: Cal.com API v2
  description: ''
  version: 1.0.0
  contact: {}
servers: []
security: []
tags: []
paths:
  /v2/events/{uuid}/co-hosts:
    get:
      tags:
        - Events
      summary: List an Event's co-hosts
      description: >-
        Returns the Event's co-hosts in their display order, with pending and
        declined invitations alongside accepted co-hosts.


        Co-hosts are people invited by email to help run the Event without
        joining the owning team. Unlike hosts — the owner and the team members
        on the Event's host roster, who can do everything — an accepted co-host
        can view and edit the Event's details and manage its guests (invite,
        approve, check in), but cannot publish, cancel or delete the Event,
        change its pricing, or manage co-hosts. An invitation grants nothing
        until the invitee accepts it while signed in with the invited email
        address.


        The authenticated user must be the Event's owner, one of its hosts, an
        accepted co-host, or a member of the owning team; an accepted co-host
        sees only the accepted co-hosts.


        PBAC permission for team events: `calEvent.read`. Learn more about API
        access control at https://cal.com/docs/api-reference/v2/access-control.


        If accessed using an OAuth access token, the `EVENT_READ` scope is
        required.
      operationId: EventCoHostsController_list
      parameters:
        - name: uuid
          required: true
          in: path
          description: >-
            Event UUID. Accepts the canonical UUID (e.g.
            `018ff5cd-6dc4-7d57-bcbc-374702ca8b38`) or its short-uuid (Flickr
            Base58) form (e.g. `1cbZYoAFoJdwqN4tixezd5`).
          schema:
            type: string
            format: uuid
        - 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
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CoHostsOutputResponseDto'
        '400':
          description: Invalid Event UUID
        '401':
          description: Unauthenticated
        '403':
          description: Insufficient permissions
        '404':
          description: Event not found
components:
  schemas:
    CoHostsOutputResponseDto:
      type: object
      properties:
        status:
          enum:
            - success
            - error
          type: string
          example: success
        data:
          type: array
          items:
            $ref: '#/components/schemas/CoHostOutputDto'
      required:
        - status
        - data
    CoHostOutputDto:
      type: object
      properties:
        id:
          type: string
          description: Id of the co-host on this Event. Not a user id.
          format: uuid
        email:
          type: string
          description: The invited email address, lowercased.
        status:
          enum:
            - PENDING
            - ACCEPTED
            - DECLINED
          type: string
        name:
          type: string
          nullable: true
          description: Display name, set once the invite is accepted.
        avatarUrl:
          type: string
          nullable: true
          description: Avatar URL, set once the invite is accepted.
      required:
        - id
        - email
        - status

````

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