# Receive booking change notifications

Endpoint that distributors must implement to receive booking change notifications.
The Bookings Group system will send HTTP POST requests to this endpoint whenever
a booking is created, updated, or cancelled.

Endpoint: POST /
Version: 1.2.0
Security: apiKey

## Request fields (application/json):

  - `eventType` (string, required)
    Type of event that triggered the notification
    Enum: "booking.updated"

  - `timestamp` (string, required)
    ISO 8601 timestamp when the event occurred

  - `bookings` (array)
    Booking data (present when eventType is booking.*)

  - `bookings.id` (string, required)
    A globally unique identifier for the reservation
    Example: "29|X9|275cc44dd2e2496fba44857c9257443a|B"

  - `bookings.compositeId` (string, required)
    A globally unique identifier for the venue/product
    Example: "29|X9|275cc44dd2e2496fba44857c9257443a|d99128c546b34b619c4477b712869f2b"

  - `bookings.date` (string, required)
    The date of the reservation (YYYY-MM-DD)
    Example: "2025-06-25"

  - `bookings.time` (string, required)
    The time of the reservation (HH:MM:SS)
    Example: "19:30:00"

  - `bookings.partySize` (integer, required)
    Number of guests for the reservation
    Example: 4

  - `bookings.status` (string, required)
    Current status of the reservation
    Enum: "pending", "confirmed", "cancelled", "completed", "no_show"

  - `bookings.reference` (string, required)
    Reference code for the reservation
    Example: "REF-20250617-001"

  - `bookings.firstName` (string, required)
    Guest's first name
    Example: "John"

  - `bookings.lastName` (string, required)
    Guest's last name
    Example: "Doe"

  - `bookings.email` (string, required)
    Email address of the guest
    Example: "john.doe@example.com"

  - `bookings.phone` (string, required)
    Phone number of the guest
    Example: "+1234567890"

  - `bookings.company` (string,null)
    Company name if the reservation is business-related
    Example: "Acme Corp"

  - `bookings.location` (object)

  - `bookings.location.address` (string)
    Street address
    Example: "123 Main Street"

  - `bookings.location.city` (string)
    City name
    Example: "New York"

  - `bookings.location.state` (string)
    State or province
    Example: "NY"

  - `bookings.location.country` (string)
    Country name
    Example: "US"

  - `bookings.location.postalCode` (string)
    Postal or ZIP code
    Example: "10001"

  - `bookings.duration` (integer, required)
    Duration of the reservation in minutes
    Example: 120

  - `bookings.productType` (string,null)
    Type of product or service reserved
    Example: "dinner"

  - `bookings.notes` (string, required)
    Additional notes for the reservation
    Example: "Window table preferred"

  - `bookings.source` (string)
    the distributor source make the booking
    Example: "MyDistributor"

  - `bookings.createdDate` (string, required)
    ISO 8601 timestamp when the reservation was created
    Example: "2025-06-17T09:15:00Z"

  - `bookings.lastUpdate` (string, required)
    ISO 8601 timestamp of the last reservation update
    Example: "2025-06-17T10:30:00Z"

  - `bookings.preorders` (array)
    List of preordered packages for the booking.

  - `bookings.preorders.packageId` (string, required)
    Unique identifier for the preordered package.

  - `bookings.preorders.name` (string)
    Package name
    Example: "*Pan roasted Padron peppers (V)"

  - `bookings.preorders.description` (string)
    Detailed package description
    Example: "5 items per guest: Salmon & celeriac on rye, Buttermilk fries chicken..."

  - `bookings.preorders.type` (string)
    Main package type
    Example: "food"

  - `bookings.preorders.quantity` (integer, required)
    Quantity of the preordered package.

  - `bookings.preorders.price` (number)
    Package price
    Example: 5.57

  - `bookings.preorderMenus` (array)
    List of preordered menus for the booking.

  - `bookings.preorderMenus.menuId` (string, required)
    Unique identifier for the preordered menu.

## Response 400 fields (application/json):

  - `error` (string)
    Error code or short description
    Example: "validation_error"

  - `message` (string)
    Detailed error message
    Example: "Required field 'booking.id' is missing"

## Response 500 fields (application/json):

  - `error` (string)
    Error code or short description
    Example: "validation_error"

  - `message` (string)
    Detailed error message
    Example: "Required field 'booking.id' is missing"


## Response 204 fields