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

# Get public appointment details

> Retrieves public appointment information that can be accessed with or without authentication



## OpenAPI

````yaml /openapi.json get /v4/appointment/public/{appointmentId}
openapi: 3.0.0
info:
  title: meetergo Platform API
  description: >-
    Comprehensive scheduling API for creating users, managing availability,
    handling bookings, and connecting calendar providers. Enables seamless
    integration with external platforms and applications.
  version: 0.0.0
  contact: {}
  termsOfService: https://www.meetergo.com/tos/
servers: []
security: []
tags:
  - name: User V4
    description: Create and manage users in your workspace
  - name: Meeting Type V4
    description: Configure meeting templates with durations, buffers, and conferencing
  - name: availability
    description: Manage weekly schedules and availability settings
  - name: Booking V4
    description: Create new bookings
  - name: Booking Availability V4
    description: Query available time slots for booking
  - name: Appointment V4
    description: Manage existing appointments
  - name: Attendee V4
    description: Manage attendee details and notes
  - name: Calendar Connections V4
    description: Connect and sync external calendars
  - name: One Time Booking Link V4
    description: Create single-use booking links
  - name: availability-exception
    description: Override availability for specific dates
  - name: Booking Link V4
    description: Configure various booking page types
  - name: Personal Page V4
    description: Manage user profile pages
  - name: Handoff V4
    description: Reassign meetings to other hosts
  - name: Calendar Auth V4
    description: OAuth callbacks for calendar providers
  - name: Queue V4
    description: Round-robin and queue-based routing (Beta)
  - name: Queue User Group V4
    description: Manage queue user groups (Beta)
  - name: Meeting Type Template V4
    description: Reusable meeting type configurations (Beta)
  - name: Attendee Pending V4
    description: Manage pending attendee approvals (Beta)
  - name: Provisional Booking V4
    description: Manage provisional/unconfirmed bookings (Beta)
paths:
  /v4/appointment/public/{appointmentId}:
    get:
      tags:
        - Appointment V4
      summary: Get public appointment details
      description: >-
        Retrieves public appointment information that can be accessed with or
        without authentication
      operationId: getPublicAppointment
      parameters:
        - name: appointmentId
          required: true
          in: path
          description: The unique identifier of the appointment
          schema:
            type: string
        - name: secret
          required: false
          in: query
          description: Optional secret key for accessing appointment details
          schema:
            type: string
      responses:
        '200':
          description: Public appointment details retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicAppointment'
components:
  schemas:
    PublicAppointment:
      type: object
      properties:
        id:
          type: string
          description: Appointment unique identifier
        meetingTypeId:
          type: string
          description: Meeting type ID associated with this appointment
        meetingInfo:
          description: Meeting information including title, duration, and other details
          allOf:
            - $ref: '#/components/schemas/MeetingInfo'
        online:
          type: boolean
          description: Whether the appointment is conducted online
        start:
          type: string
          description: Appointment start time (ISO string)
        end:
          type: string
          description: Appointment end time (ISO string)
        isCancelled:
          type: boolean
          description: Whether the appointment has been cancelled
        location:
          type: string
          description: Physical location address
        channel:
          description: Meeting channel type (e.g., video conference platform)
          allOf:
            - $ref: '#/components/schemas/MeetingTypeChannel'
        hosts:
          description: List of appointment hosts with basic information
          allOf:
            - $ref: '#/components/schemas/PublicAppointmentHost'
        company:
          description: Public company information
          allOf:
            - $ref: '#/components/schemas/PublicCompanyInfo'
        disableActionButtons:
          type: boolean
          description: >-
            Whether action buttons (reschedule, cancel) are disabled for this
            appointment
        cancellationPolicy:
          description: Cancellation policy for this appointment
          allOf:
            - $ref: '#/components/schemas/CancellationPolicySetting'
        reschedulingPolicy:
          description: Rescheduling policy for this appointment
          allOf:
            - $ref: '#/components/schemas/ReschedulingPolicySetting'
        language:
          type: string
          description: Attendee's resolved language for this booking
        meetingLink:
          type: string
          description: Meeting link - only provided with proper authentication
        ics:
          type: string
          description: ICS calendar file content - only provided with proper authentication
        customCss:
          type: string
          description: Custom CSS styling for the appointment page
        showConfetti:
          type: boolean
          description: Whether to show confetti animation on the confirmation page
        queueId:
          type: string
          description: Queue ID - required for rescheduling on round robin meetings
        recurringSeriesId:
          type: string
          description: >-
            Recurring series ID if this appointment is part of a recurring
            series
        occurrenceNumber:
          type: number
          description: 1-based index of this appointment within the recurring series
        recurringSeries:
          description: >-
            Recurring series information if this appointment is part of a
            recurring series
          allOf:
            - $ref: '#/components/schemas/PublicRecurringSeries'
        isBundleBooking:
          type: boolean
          description: Whether this appointment was booked as part of a bundle
        bundleId:
          type: string
          description: Bundle ID if this is a bundle booking
        bundleItems:
          description: Bundle items if this is a bundle booking
          type: array
          items:
            $ref: '#/components/schemas/PublicBundleItem'
      required:
        - id
        - meetingInfo
        - online
        - start
        - end
        - isCancelled
        - channel
        - hosts
        - company
        - disableActionButtons
        - language
        - showConfetti
    MeetingInfo:
      type: object
      properties:
        name:
          type: string
          description: Name of the meeting type
        description:
          type: string
          description: Description of the meeting type
        enableRedirect:
          type: boolean
          description: Enable redirect after booking completion
        redirect:
          type: string
          description: Redirect URL to navigate after booking
        passEventDetailsToRedirect:
          type: boolean
          description: >-
            Pass event details (invitee name, email, form answers) as query
            params to redirect URL
        duration:
          type: number
          description: Primary duration in minutes
        channel:
          description: Meeting channel/location type
          allOf:
            - $ref: '#/components/schemas/MeetingTypeChannel'
        customChannelName:
          type: string
          description: Custom name for the meeting channel
        customChannelLink:
          type: string
          description: Custom link for the meeting channel
        groupBooking:
          type: boolean
          description: Enable group booking (multiple attendees per slot)
        showAvailableSlots:
          type: boolean
          description: Show available spots count on the booking page
        enrichInvitee:
          type: boolean
          description: Enable invitee data enrichment
        confirmationButton:
          description: Confirmation button settings
          allOf:
            - $ref: '#/components/schemas/ConfirmationButton'
        bufferBefore:
          type: number
          description: Buffer time before meeting in minutes
        bufferAfter:
          type: number
          description: Buffer time after meeting in minutes
        color:
          type: object
          description: Color for the meeting type in RGB format, e.g. "rgb(0, 153, 255)"
          nullable: true
      required:
        - name
        - description
        - enableRedirect
        - redirect
        - passEventDetailsToRedirect
        - duration
        - channel
        - customChannelName
        - customChannelLink
        - groupBooking
        - showAvailableSlots
        - enrichInvitee
        - confirmationButton
        - bufferBefore
        - bufferAfter
    MeetingTypeChannel:
      type: string
      enum:
        - local
        - local-attendee
        - google
        - zoom
        - phone
        - phone-incoming
        - whatsapp
        - connect
        - webex
        - skypeForConsumer
        - skypeForBusiness
        - teamsForBusiness
        - teamsForBusiness2
        - teamsForExchange
        - teams2ForExchange
        - custom
        - resource
        - whereby
        - kmeet
        - zava
        - jitsi
      description: Meeting channel/location type
    PublicAppointmentHost:
      type: object
      properties:
        id:
          type: string
          description: Host user unique identifier
        firstname:
          type: string
          description: Host first name
        lastname:
          type: string
          description: Host last name
        picture:
          type: string
          description: Host profile picture URL
      required:
        - id
        - firstname
        - lastname
    PublicCompanyInfo:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
        description:
          type: string
        logo:
          type: string
        tier:
          allOf:
            - $ref: '#/components/schemas/CompanyTier'
        primaryColor:
          type: string
        useBrandStyling:
          type: boolean
        hideMeetergoBranding:
          type: boolean
        showDataPolicyLink:
          type: boolean
        hideDataPolicyCheckbox:
          type: boolean
        dataPolicyLink:
          type: string
          nullable: true
        imprintLink:
          type: string
          nullable: true
        deleted:
          type: boolean
        useFormalBookingLanguage:
          type: boolean
        enableCustomLegalText:
          type: boolean
        enableCookieBanner:
          type: boolean
        customLegalText:
          type: string
        customBookingCSS:
          type: string
        featureAccess:
          $ref: '#/components/schemas/FeatureAccess'
        language:
          type: string
        allowedLanguages:
          type: array
          items:
            type: string
        googleAnalyticsMeasurementId:
          type: string
          nullable: true
        metaPixelId:
          type: string
          nullable: true
        gtmContainerId:
          type: string
          nullable: true
      required:
        - id
        - name
        - description
        - tier
        - primaryColor
        - useBrandStyling
        - hideMeetergoBranding
        - showDataPolicyLink
        - hideDataPolicyCheckbox
        - dataPolicyLink
        - imprintLink
        - deleted
        - useFormalBookingLanguage
        - enableCustomLegalText
        - enableCookieBanner
        - customLegalText
        - customBookingCSS
        - featureAccess
        - language
        - googleAnalyticsMeasurementId
        - metaPixelId
        - gtmContainerId
    CancellationPolicySetting:
      type: object
      properties:
        enable:
          type: boolean
        mode:
          type: string
          enum:
            - disabled
            - hours
            - days
        duration:
          type: number
      required:
        - enable
    ReschedulingPolicySetting:
      type: object
      properties:
        enable:
          type: boolean
        mode:
          type: string
          enum:
            - disabled
            - hours
            - days
        duration:
          type: number
      required:
        - enable
    PublicRecurringSeries:
      type: object
      properties:
        id:
          type: string
          description: Series ID
        mode:
          enum:
            - recurring
            - multi_slot
          type: string
          description: Mode of the series (recurring or multi_slot)
        frequency:
          nullable: true
          enum:
            - weekly
            - biweekly
            - monthly
          type: string
          description: Frequency of the series (only for recurring mode)
        totalOccurrences:
          type: number
          description: Total number of occurrences in this series
        appointments:
          description: All appointments in this series
          type: array
          items:
            $ref: '#/components/schemas/RecurringSeriesAppointment'
      required:
        - id
        - mode
        - totalOccurrences
        - appointments
    PublicBundleItem:
      type: object
      properties:
        meetingTypeId:
          type: string
          description: Meeting type ID
        meetingTypeName:
          type: string
          description: Meeting type name
        duration:
          type: number
          description: Duration in minutes
        price:
          type: number
          description: Price
        startTime:
          type: string
          description: Start time of this segment (ISO string)
        endTime:
          type: string
          description: End time of this segment (ISO string)
        sortOrder:
          type: number
          description: Order in the bundle
        hosts:
          description: Hosts for this segment
          type: array
          items:
            $ref: '#/components/schemas/PublicAppointmentHost'
      required:
        - meetingTypeId
        - meetingTypeName
        - duration
        - startTime
        - endTime
        - sortOrder
        - hosts
    ConfirmationButton:
      type: object
      properties:
        useConfirmationButton:
          type: boolean
        text:
          type: string
        color:
          type: string
        link:
          type: string
      required:
        - useConfirmationButton
        - text
        - color
        - link
    CompanyTier:
      type: string
      enum:
        - basic
        - essentials
        - growth
        - teams
        - enterprise
    FeatureAccess:
      type: object
      properties:
        polls:
          type: boolean
        advancedMeetingTypeSettings:
          type: boolean
        workflows:
          type: boolean
        meetingTypeCommunications:
          type: boolean
        multiHostBooking:
          type: boolean
        groupBooking:
          type: boolean
        enrichInvitee:
          type: boolean
        zapier:
          type: boolean
        personalizedBranding:
          type: boolean
        crmIntegration:
          type: boolean
        routingForms:
          type: boolean
        basicForms:
          type: boolean
        selectionPages:
          type: boolean
        dataFields:
          type: boolean
        roundRobin:
          type: boolean
        handoff:
          type: boolean
        reschedule:
          type: boolean
        notifications:
          type: boolean
        workspaces:
          type: boolean
        sendgridIntegration:
          type: boolean
        api:
          type: boolean
        showcaseHubs:
          type: boolean
        meetergoConnect:
          type: boolean
        webhooks:
          type: boolean
        wallets:
          type: boolean
        dealSpace:
          type: boolean
        funnel:
          type: boolean
        unlimitedMeetingTypes:
          type: boolean
        salesforceIntegration:
          type: boolean
        salesforceStudioMapping:
          type: boolean
        maximumCalendars:
          type: number
        disableIntercom:
          type: boolean
        evalancheIntegration:
          type: boolean
        analytics:
          type: boolean
        bookingFunnel:
          type: boolean
        funnelProgressAndInfobox:
          type: boolean
        contactsBeta:
          type: boolean
        paypalIntegration:
          type: boolean
        stripeIntegration:
          type: boolean
        meetingTypeTemplates:
          type: boolean
        nextBeta:
          type: boolean
        video:
          type: boolean
        emailLayout:
          type: boolean
        reviews:
          type: boolean
        brevoIntegration:
          type: boolean
        getResponseIntegration:
          type: boolean
        customDomain:
          type: boolean
        maxCustomDomains:
          type: number
        apiPlatform:
          type: boolean
        slackIntegration:
          type: boolean
        calgent:
          type: boolean
        fileUploads:
          type: boolean
        storageQuotaMB:
          type: number
        multiBooking:
          type: boolean
        bundles:
          type: boolean
        maxCrmDeals:
          type: number
        maxShowcaseHubs:
          type: number
        maxDealSpaces:
          type: number
        waitlist:
          type: boolean
        quickMail:
          type: boolean
        enrichDealSpaceCompany:
          type: boolean
        whatsappAddon:
          type: boolean
        bookingCoupons:
          type: boolean
        crmEmailSync:
          type: boolean
      required:
        - polls
        - advancedMeetingTypeSettings
        - workflows
        - meetingTypeCommunications
        - multiHostBooking
        - groupBooking
        - enrichInvitee
        - zapier
        - personalizedBranding
        - crmIntegration
        - routingForms
        - basicForms
        - selectionPages
        - dataFields
        - roundRobin
        - handoff
        - reschedule
        - notifications
        - workspaces
        - sendgridIntegration
        - api
        - showcaseHubs
        - meetergoConnect
        - webhooks
        - wallets
        - dealSpace
        - funnel
        - unlimitedMeetingTypes
        - salesforceIntegration
        - salesforceStudioMapping
        - maximumCalendars
        - disableIntercom
        - evalancheIntegration
        - analytics
        - bookingFunnel
        - funnelProgressAndInfobox
        - contactsBeta
        - paypalIntegration
        - stripeIntegration
        - meetingTypeTemplates
        - nextBeta
        - video
        - emailLayout
        - reviews
        - brevoIntegration
        - getResponseIntegration
        - customDomain
        - maxCustomDomains
        - apiPlatform
        - slackIntegration
        - calgent
        - fileUploads
        - storageQuotaMB
        - multiBooking
        - bundles
        - maxCrmDeals
        - maxShowcaseHubs
        - maxDealSpaces
        - waitlist
        - quickMail
        - enrichDealSpaceCompany
        - whatsappAddon
        - bookingCoupons
        - crmEmailSync
    RecurringSeriesAppointment:
      type: object
      properties:
        id:
          type: string
          description: Appointment ID
        start:
          type: string
          description: Appointment start time (ISO string)
        end:
          type: string
          description: Appointment end time (ISO string)
        isCancelled:
          type: boolean
          description: Whether the appointment has been cancelled
        occurrenceNumber:
          type: number
          description: 1-based index in the recurring series
        secret:
          type: string
          description: >-
            Secret for this appointment - only included when caller is
            authenticated
      required:
        - id
        - start
        - end
        - isCancelled
        - occurrenceNumber

````