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

# Get booking

> Get a booking by SID.

With a user session, a member who can view the whole workspace's bookings can open any of them. Any other member can only open the bookings they host, plus the bookings they created themselves when their role lets them manage the bookings they booked.


<Info>Replace `{your-subdomain}` with your workspace’s subdomain. <br /> Learn how to find your subdomain in [Workspace subdomain](/api/workspace-subdomain).</Info>


## OpenAPI

````yaml bundled/bookings.yaml GET /bookings/{booking_sid}
openapi: 3.0.3
info:
  title: NeetoCal Bookings APIs
  version: 2.0.0
servers:
  - description: NeetoCal APIs
    url: https://{your-subdomain}.neetocal.com/api/external/v2
    variables:
      your-subdomain:
        default: spinkart
        description: >-
          Replace **spinkart** with your [workspace's
          subdomain](/api/workspace-subdomain).
security: []
tags:
  - name: Bookings
    description: >-
      APIs to create, list, and update bookings (reschedule, approve, reject, or
      cancel via the update endpoint).
paths:
  /bookings/{booking_sid}:
    get:
      tags:
        - Bookings
      summary: Get booking details
      description: >
        Get a booking by SID.


        With a user session, a member who can view the whole workspace's
        bookings can open any of them. Any other member can only open the
        bookings they host, plus the bookings they created themselves when their
        role lets them manage the bookings they booked.
      parameters:
        - $ref: '#/components/parameters/api_key_header'
        - in: path
          name: booking_sid
          description: SID of the booking you want to retrieve.
          required: true
          schema:
            type: string
            example: 8sqtzrs
      responses:
        '200':
          description: OK - Request succeeded
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/booking'
              example:
                id: efb296a3-8205-419f-8ac4-1abfc46bc3c7
                sid: 8sqtzrs
                parent_booking_id: null
                name: John Doe
                email: john.doe@example.com
                host_name: Jane Smith
                host_email: jane@bigbinary.com
                is_multihost: false
                multihosts:
                  - name: Jane Smith
                    email: jane@bigbinary.com
                starts_at: '2025-07-23T05:00:00.000Z'
                ends_at: '2025-07-23T05:15:00.000Z'
                time_zone: Asia/Kolkata
                starts_at_for_client: '2025-07-23T10:30:00.000+05:30'
                ends_at_for_client: '2025-07-23T10:45:00.000+05:30'
                status: confirmed
                cancel_reason: null
                cancelled_by: null
                reschedule_requested: false
                preferred_meeting_spot: jitsi
                room_type: jitsi
                room_url: https://jitsi.neetocal.com/meeting-with-jane-of-jane-d12ec
                room_id: null
                spot_details: https://jitsi.neetocal.com/meeting-with-jane-of-jane-d12ec
                created_at: '2025-07-22T06:29:35.963Z'
                updated_at: '2025-07-22T06:31:33.090Z'
                meeting_id: 8a7794e3-3142-4569-9dd7-6411369b5d3f
                meeting:
                  name: Product Demo Meeting
                no_show: false
                meeting_outcome:
                  id: 59413def-60eb-47c6-b390-098fcf583b66
                  name: Pricing Discussion
                  color: yellow
                  kind: custom
                  color_hex: '#EAB308'
                  is_system: false
                  is_organization_owned: true
                internal_notes: null
                metadata: {}
                admin_booking_url: https://jane-bigbinary.neetocal.com/admin/bookings/8sqtzrs
                client_booking_url: https://jane-bigbinary.neetocal.com/booking/8sqtzrs
                form_responses:
                  - field: Name
                    value: John Doe
                    type: name
                    field_code: name
                    Name: John Doe
                  - field: Email
                    value: john.doe@example.com
                    type: email
                    field_code: email
                    Email: john.doe@example.com
                  - field: Guest email(s)
                    value: []
                    type: additional_guests
                    field_code: guest_email_s
                    Guest email(s): []
                form_responses_as_hash:
                  name: John Doe
                  email: john.doe@example.com
                  guest_email_s: []
components:
  parameters:
    api_key_header:
      in: header
      name: X-Api-Key
      description: >-
        Use the X-Api-Key header to provide your workspace API key. Refer to
        [Authentication](/api/authentication) for more information.
      required: true
      schema:
        type: string
  schemas:
    booking:
      type: object
      properties:
        id:
          type: string
          description: Unique identifier for the booking.
        sid:
          type: string
          description: Short identifier (SID) for the booking, used in URLs and API calls.
        parent_booking_id:
          type: string
          nullable: true
          description: Reference to the parent booking if this is a group booking.
        email:
          type: string
          description: Email address of the person who made the booking.
        name:
          type: string
          description: Name of the person who made the booking.
        host_name:
          type: string
          description: Name of the primary host for the meeting.
        host_email:
          type: string
          description: Email address of the primary host for the meeting.
        is_multihost:
          type: boolean
          description: Whether the meeting has multiple hosts.
        multihosts:
          type: array
          items:
            type: object
            properties:
              name:
                type: string
                description: Name of the host.
              email:
                type: string
                description: Email address of the host.
          description: List of all hosts for the meeting when is_multihost is true.
        starts_at:
          type: string
          format: date-time
          description: Start time of the booking in UTC.
        ends_at:
          type: string
          format: date-time
          description: End time of the booking in UTC.
        time_zone:
          type: string
          description: Time zone of the booking location.
        starts_at_for_client:
          type: string
          description: Start time of the booking in the client's local time zone.
        ends_at_for_client:
          type: string
          description: End time of the booking in the client's local time zone.
        status:
          type: string
          description: >-
            Current status of the booking (e.g., confirmed, cancelled,
            awaiting_approval, rejected).
        cancel_reason:
          type: string
          nullable: true
          description: Reason provided when the booking was cancelled.
        cancelled_by:
          type: string
          nullable: true
          description: Name of the person who cancelled the booking.
        reschedule_requested:
          type: boolean
          description: Whether a reschedule has been requested for this booking.
        preferred_meeting_spot:
          type: string
          description: Preferred meeting platform or location type selected by the client.
        room_type:
          type: string
          nullable: true
          description: |
            Type of meeting room or platform being used.
          enum:
            - daily
            - zoom
            - jitsi
            - google_meet
            - teams
            - whereby
            - in_person
            - custom
            - phone_call
        room_url:
          type: string
          nullable: true
          description: URL for the meeting room or platform.
        room_id:
          type: string
          nullable: true
          description: Unique identifier for the meeting room or platform.
        spot_details:
          type: string
          nullable: true
          description: Additional details about the meeting place.
        created_at:
          type: string
          format: date-time
          description: Timestamp when the booking was created.
        updated_at:
          type: string
          format: date-time
          description: Timestamp when the booking was last updated.
        meeting_id:
          type: string
          description: Unique identifier of the scheduling link this booking belongs to.
        meeting:
          type: object
          properties:
            name:
              type: string
              description: Name of the scheduling link.
          description: Basic information about the associated meeting.
        no_show:
          type: boolean
          description: Whether the booking is marked as no-show by the host.
        is_overridden:
          type: boolean
          description: >-
            Whether the booking was made or rescheduled outside the scheduling
            link's availability.
        bypassed_rules:
          type: array
          items:
            type: string
          description: >-
            Messages for the availability checks skipped by
            `override_availability` (e.g., "Host is not available at the time").
            Only included in the response to that create or update request.
        meeting_outcome:
          nullable: true
          description: Meeting outcome assigned to the booking.
          allOf:
            - $ref: '#/components/schemas/meeting_outcome'
        notes_url:
          type: string
          nullable: true
          description: URL to access notes or additional information about the booking.
        internal_notes:
          type: string
          nullable: true
          description: Internal notes about the booking visible only to hosts and admins.
        metadata:
          type: object
          nullable: true
          description: Additional custom data associated with the booking.
        admin_booking_url:
          type: string
          description: URL for hosts and admins to view and manage the booking.
        client_booking_url:
          type: string
          description: URL for clients to view their booking details.
        form_responses:
          type: array
          items:
            type: object
            properties:
              field:
                type: string
                description: Display name of the form field.
              value:
                type: string
                description: Value submitted for the form field.
              type:
                type: string
                description: Type of the form field (e.g., name, email, additional_guests).
              field_code:
                type: string
                description: Internal code identifier for the form field.
          description: Responses submitted through the booking form.
        form_responses_as_hash:
          type: object
          description: Form responses organized as key-value pairs for easier access.
          additionalProperties:
            type: string
        add_on_services:
          type: array
          description: Add-on services chosen for the booking.
          items:
            $ref: '#/components/schemas/booking_add_on_service'
        payment:
          nullable: true
          description: >-
            Payment details for the booking. Included only when a payment exists
            for the booking.
          allOf:
            - $ref: '#/components/schemas/booking_payment'
    meeting_outcome:
      type: object
      properties:
        id:
          type: string
          description: Unique identifier for the meeting outcome.
          example: 59413def-60eb-47c6-b390-098fcf583b66
        name:
          type: string
          description: Name of the meeting outcome.
          example: Pricing Discussion
        color:
          type: string
          description: Color assigned to the meeting outcome.
          enum:
            - blue
            - orange
            - gray
            - red
            - yellow
            - violet
            - pink
            - teal
            - cyan
            - green
          example: yellow
        kind:
          type: string
          description: Kind of the meeting outcome.
          example: custom
        color_hex:
          type: string
          description: Hex color code for the meeting outcome.
          example: '#EAB308'
        is_system:
          type: boolean
          description: >-
            Whether this is a system-defined meeting outcome. System outcomes
            cannot be modified or deleted.
          example: false
        is_organization_owned:
          type: boolean
          description: Whether this outcome belongs to the organization.
          example: true
    booking_add_on_service:
      type: object
      description: >-
        Add-on service selected for a booking, with its name, duration and price
        as they were when the booking was made.
      properties:
        id:
          type: string
          description: Unique identifier for the booking's add-on service record.
          example: 0d3c1e8a-58b7-4c1f-a7f3-3c2f5d1b9e10
        add_on_service_id:
          type: string
          description: ID of the scheduling link's add-on service.
          example: 77150ec6-d4f0-4665-98f0-34bda69f7b3a
        name:
          type: string
          example: Sauna
        duration:
          type: integer
          description: Minutes the add-on service added to the booking.
          example: 30
        amount:
          type: string
          description: Price charged for the add-on service.
          example: '25.5'
        currency:
          type: string
          nullable: true
          example: USD
        free:
          type: boolean
          description: Whether the add-on service was free.
          example: false
    booking_payment:
      type: object
      description: >
        Payment details associated with the booking. Present only when a payment
        exists for the booking.
      properties:
        id:
          type: string
          format: uuid
          description: Unique identifier of the payment record.
          example: f46c9ddf-221d-4238-afb2-280c1c6b3185
        external_id:
          type: string
          nullable: true
          description: Payment reference ID from the payment provider.
          example: pi_3ThCkv2c3CtEndqE1BwejQno
        provider:
          type: string
          description: Payment provider that processed the payment.
          example: stripe
        amount:
          type: string
          description: Payment amount.
          example: '100.0'
        currency:
          type: string
          description: Currency code. Follows the ISO 4217 standard.
          example: USD
        status:
          type: string
          description: Current status of the payment.
          example: successful
        successful:
          type: boolean
          description: Whether the payment was completed successfully.
          example: true
        payment_at:
          type: string
          format: date-time
          nullable: true
          description: Timestamp when the payment was made.
          example: '2026-06-11T17:51:09.321Z'

````

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