---
title: "POST /api/hotel/{hotelId}/{token}/book"
method: POST
path: "/api/hotel/{hotelId}/{token}/book"
tags: ["Hotel"]
---

# POST /api/hotel/{hotelId}/{token}/book

`POST /api/hotel/{hotelId}/{token}/book`

## Path parameters

- `hotelId` string, required
- `token` string, required

## Headers

- `accountId` string, required
- `apiKey` string, required

## Request body

- HotelAPIDataContractBookRequestBookRq
  - `rateIds` string[], nullable
  - `originalBookingId` string, nullable
  - `bookingRefId` string, nullable
  - `specialRequests` string[], nullable
  - `roomsAllocations` HotelAPIDataContractBookRequestRoomsAllocation[], nullable
    - `roomId` string, nullable
    - `rateId` string, nullable
    - `guests` HotelAPIDataContractCommonPerson[], nullable
      - `title` string, nullable
      - `firstName` string, nullable
      - `lastName` string, nullable
      - `middleName` string, nullable
      - `suffix` string, nullable
      - `age` integer
      - `contact` HotelAPIDataContractCommonContact
        - `phone` string, nullable
        - `address` HotelAPIDataContractCommonAddress
          - `line1` string, nullable
          - `line2` string, nullable
          - `city` HotelAPIDataContractCommonRegion
            - `name` string, nullable
            - `code` string, nullable
          - `state` HotelAPIDataContractCommonRegion
            - `name` string, nullable
            - `code` string, nullable
          - `country` HotelAPIDataContractCommonRegion
            - `name` string, nullable
            - `code` string, nullable
          - `postalCode` string, nullable
        - `email` string, nullable
      - `memberships` HotelAPIDataContractCommonMembership[], nullable
        - `chainCode` string, nullable
        - `number` string, nullable
      - `type` string, nullable
      - `email` string, nullable
      - `panCardNumber` string, nullable
      - `Passport` HotelAPIDataContractCommonPassport
        - `passportNo` string, nullable
        - `passportIssueDate` string, date-time
        - `passportExpDate` string, date-time
  - `billingContact` HotelAPIDataContractCommonPerson
    - `title` string, nullable
    - `firstName` string, nullable
    - `lastName` string, nullable
    - `middleName` string, nullable
    - `suffix` string, nullable
    - `age` integer
    - `contact` HotelAPIDataContractCommonContact
      - `phone` string, nullable
      - `address` HotelAPIDataContractCommonAddress
        - `line1` string, nullable
        - `line2` string, nullable
        - `city` HotelAPIDataContractCommonRegion
          - `name` string, nullable
          - `code` string, nullable
        - `state` HotelAPIDataContractCommonRegion
          - `name` string, nullable
          - `code` string, nullable
        - `country` HotelAPIDataContractCommonRegion
          - `name` string, nullable
          - `code` string, nullable
        - `postalCode` string, nullable
      - `email` string, nullable
    - `memberships` HotelAPIDataContractCommonMembership[], nullable
      - `chainCode` string, nullable
      - `number` string, nullable
    - `type` string, nullable
    - `email` string, nullable
    - `panCardNumber` string, nullable
    - `Passport` HotelAPIDataContractCommonPassport
      - `passportNo` string, nullable
      - `passportIssueDate` string, date-time
      - `passportExpDate` string, date-time
  - `company` HotelAPIDataContractCommonOrganization
    - `name` string, nullable
    - `gstNumber` string, nullable
    - `contactPerson` HotelAPIDataContractCommonPerson
      - `title` string, nullable
      - `firstName` string, nullable
      - `lastName` string, nullable
      - `middleName` string, nullable
      - `suffix` string, nullable
      - `age` integer
      - `contact` HotelAPIDataContractCommonContact
        - `phone` string, nullable
        - `address` HotelAPIDataContractCommonAddress
          - `line1` string, nullable
          - `line2` string, nullable
          - `city` HotelAPIDataContractCommonRegion
            - `name` string, nullable
            - `code` string, nullable
          - `state` HotelAPIDataContractCommonRegion
            - `name` string, nullable
            - `code` string, nullable
          - `country` HotelAPIDataContractCommonRegion
            - `name` string, nullable
            - `code` string, nullable
          - `postalCode` string, nullable
        - `email` string, nullable
      - `memberships` HotelAPIDataContractCommonMembership[], nullable
        - `chainCode` string, nullable
        - `number` string, nullable
      - `type` string, nullable
      - `email` string, nullable
      - `panCardNumber` string, nullable
      - `Passport` HotelAPIDataContractCommonPassport
        - `passportNo` string, nullable
        - `passportIssueDate` string, date-time
        - `passportExpDate` string, date-time
    - `contact` HotelAPIDataContractCommonContact
      - `phone` string, nullable
      - `address` HotelAPIDataContractCommonAddress
        - `line1` string, nullable
        - `line2` string, nullable
        - `city` HotelAPIDataContractCommonRegion
          - `name` string, nullable
          - `code` string, nullable
        - `state` HotelAPIDataContractCommonRegion
          - `name` string, nullable
          - `code` string, nullable
        - `country` HotelAPIDataContractCommonRegion
          - `name` string, nullable
          - `code` string, nullable
        - `postalCode` string, nullable
      - `email` string, nullable
  - `additionalData` HotelAPIDataContractCommonAttribute[], nullable
    - `name` string, nullable
    - `value` string, nullable
  - `paymentInformation` HotelAPIDataContractCommonPaymentInformation[], nullable
    - `key` string, nullable
    - `value` string, nullable
  - `transactionId` string, nullable
  - `paymentStatus` string, nullable
  - `agentDetail` HotelAPIDataContractBookRequestAgentDetail
    - `agentEmail` string, nullable
    - `agencyId` string, nullable
    - `grandParentId` string, nullable
  - `totalRate` number, double
  - `domain` string, nullable
  - `loggedInUserEmail` string, nullable
  - `guestNames` string, nullable
  - `bookingTag` HotelAPIDataContractBookRequestBookingTag
    - `campaignId` string, nullable
    - `onHold` boolean, nullable
    - `isApiOut` boolean, nullable
    - `clientReferenceNumber` string, nullable
  - `paymentDueDate` string, date-time, nullable
  - `agentMarkup` HotelAPIDataContractBookRequestAgentMarkup
    - `amount` number, double
    - `description` string, nullable
  - `depositCharge` HotelAPIDataContractCommonDepositCharge
    - `depositType` 'Percentage' | 'Amount'
    - `amount` number, double
    - `currency` string, nullable
    - `description` string, nullable
  - `travelPurpose` 'Leisure' | 'Business'
  - `creditCard` HotelAPIDataContractBookRequestCreditCard
    - `number` string, nullable
    - `nameOnCard` string, nullable
    - `issuer` string, nullable
    - `contact` HotelAPIDataContractBookRequestCardContactInfo
      - `phone` string, nullable
      - `billingAddress` HotelAPIDataContractCommonAddress
        - `line1` string, nullable
        - `line2` string, nullable
        - `city` HotelAPIDataContractCommonRegion
          - `name` string, nullable
          - `code` string, nullable
        - `state` HotelAPIDataContractCommonRegion
          - `name` string, nullable
          - `code` string, nullable
        - `country` HotelAPIDataContractCommonRegion
          - `name` string, nullable
          - `code` string, nullable
        - `postalCode` string, nullable
      - `email` string, nullable
    - `token` string, nullable
    - `cvv` integer
    - `expiryMonth` integer
    - `expiryYear` integer

## Response `200`

Success

- HotelAPIDataContractBookResponseBookRs
  - `token` string, nullable
  - `bookingStatus` 'Confirmed' | 'Pending' | 'Failed' | 'Planned' | 'Cancelled' | 'ConfirmationPending' | 'CancellationPending' | 'Created' | 'Initiated' | 'CancellationFailed' | 'ChangeRequested' | 'CancellationRequested'
  - `bookingId` string, nullable
  - `providerConfirmationNumber` string, nullable
  - `hotelConfirmationNumber` string, nullable
  - `cancellationToken` string, nullable
  - `roomConfirmation` HotelAPIDataContractCommonRoomConfirmationInfo[], nullable
    - `rateId` string, nullable
    - `roomId` string, nullable
    - `providerConfirmationNumber` string, nullable
    - `hotelConfirmationNumber` string, nullable
    - `hotelCancellationNumber` string, nullable
    - `providerCancellationNumber` string, nullable
    - `cancellationToken` string, nullable
    - `bookingStatus` string, nullable
  - `supplierBookingPaymentDate` string, nullable
  - `Error` HotelAPIDataContractError
    - `code` string, nullable
    - `message` string, nullable
  - `additionalInformation` HotelAPIDataContractCommonAdditionalInformation[], nullable
    - `type` string, nullable
    - `text` string, nullable
  - `paymentInformation` HotelAPIDataContractCommonPaymentInformation[], nullable
    - `key` string, nullable
    - `value` string, nullable
  - `supplierBookingReference` string, nullable

## Other responses

- `400` — ClientSideError

---

[API](https://skmtc.net/zentrumhub/apis/hotelcontent-api.md) · [All operations](https://skmtc.net/zentrumhub/apis/hotelcontent-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/zentrumhub/hotelcontent-api/revisions/9fa4830db488/schema)