> ## 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.

# Count an Event's guests

> Returns how many of the Event's guests are in each status, how many answered each RSVP, how many are checked in and how many seats each location holds, as the roster's tabs show them. The authenticated user must be the Event's owner, one of its hosts, an accepted co-host, or a member of the owning team. PBAC permission for team events: `calEvent.read`. If accessed using an OAuth access token, the `EVENT_READ` scope is required.



## OpenAPI

````yaml /api-reference/v2/openapi.json get /v2/events/{uuid}/registrations/counts
openapi: 3.0.0
info:
  title: Cal.com API v2
  description: ''
  version: 1.0.0
  contact: {}
servers: []
security: []
tags: []
paths:
  /v2/events/{uuid}/registrations/counts:
    get:
      tags:
        - Events
      summary: Count an Event's guests
      description: >-
        Returns how many of the Event's guests are in each status, how many
        answered each RSVP, how many are checked in and how many seats each
        location holds, as the roster's tabs show them. The authenticated user
        must be the Event's owner, one of its hosts, an accepted co-host, or a
        member of the owning team. PBAC permission for team events:
        `calEvent.read`. If accessed using an OAuth access token, the
        `EVENT_READ` scope is required.
      operationId: EventRegistrationsController_counts
      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/RegistrationCountsOutputResponseDto'
        '400':
          description: Invalid Event UUID
        '401':
          description: Unauthenticated
        '403':
          description: Insufficient permissions
        '404':
          description: Event not found
components:
  schemas:
    RegistrationCountsOutputResponseDto:
      type: object
      properties:
        status:
          enum:
            - success
            - error
          type: string
          example: success
        data:
          $ref: '#/components/schemas/RegistrationCountsOutputDto'
      required:
        - status
        - data
    RegistrationCountsOutputDto:
      type: object
      properties:
        pendingApproval:
          type: number
          description: Guests waiting for approval.
        waitlisted:
          type: number
          description: Guests on the waitlist.
        pendingPayment:
          type: number
          description: Guests sent a payment request who have not paid yet.
        offerExpired:
          type: number
          description: Guests whose payment request expired.
        declined:
          type: number
          description: Declined guests.
        cancelled:
          type: number
          description: Guests who cancelled.
        confirmed:
          type: number
          description: Confirmed guests, whatever their RSVP.
        going:
          type: number
          description: Confirmed guests who answered Yes.
        checkedIn:
          type: number
          description: Confirmed guests with a recorded door check-in.
        rsvpResponses:
          $ref: '#/components/schemas/RegistrationRsvpCountsOutputDto'
        byLocation:
          description: Seats held per location.
          type: array
          items:
            $ref: '#/components/schemas/RegistrationLocationCountOutputDto'
      required:
        - pendingApproval
        - waitlisted
        - pendingPayment
        - offerExpired
        - declined
        - cancelled
        - confirmed
        - going
        - checkedIn
        - rsvpResponses
        - byLocation
    RegistrationRsvpCountsOutputDto:
      type: object
      properties:
        'yes':
          type: number
          description: Guests who answered Yes, in any status.
        'no':
          type: number
          description: Guests who answered No, in any status.
        maybe:
          type: number
          description: Guests who answered Maybe, in any status.
      required:
        - 'yes'
        - 'no'
        - maybe
    RegistrationLocationCountOutputDto:
      type: object
      properties:
        locationId:
          type: string
          nullable: true
          description: Event location id, or null for guests not registered for a location.
        count:
          type: number
          description: >-
            Seats held at this location by confirmed guests and guests holding a
            seat while they pay or confirm.
      required:
        - count

````

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