---
title: "Create a new hotel booking"
method: POST
path: "/v2/hotel/create-pnr"
tags: ["Hotel"]
---

# Create a new hotel booking

`POST /v2/hotel/create-pnr`

Creates a new hotel booking for the given request parameters.

## Request body

- HotelCreatePnrRequest — Defines the structure of a hotel create pnr request
  - `bookingKey` string, required — The booking key for the hotel booking.
  - `travelers` HotelTraveler[], required — The list of travelers and their details. The traveler at index 0 will be considered as the primary traveler and their details will be passed to the supplier.
    - `travelerId` UserId, required — User identifier
      - `id` string, uuid, required
    - `name` Name, required — Full name containing first, middle, last (family) names, and suffix.
      - `family1` string, required — Last (family) name.
      - `family2` string
      - `given` string, required — First (given) name.
      - `middle` string — Middle name.
      - `suffix` 'NAME_SUFFIX_UNKNOWN' | 'SR' | 'JR' | 'MD' | 'PHD' | 'II' | 'III' | 'IV' | 'DO' | 'ATTY' | 'V' | 'VI' | 'ESQ' | 'DC' | 'DDS' | 'VM' | 'JD' | 'SECOND' | 'THIRD' — Suffix for name
      - `preferred` string — Informal preferred name added by traveler. This is not used on any PNR or tickets
    - `dob` DateModel — Date in ISO 8601 standard.
      - `iso8601` string, required
    - `phoneNumber` PhoneNumber, required — Properly formatted phone number.
      - `countryCode` integer — two digit country code
      - `countryCodeSource` 'UNSPECIFIED' | 'FROM_NUMBER_WITH_PLUS_SIGN' | 'FROM_NUMBER_WITH_IDD' | 'FROM_NUMBER_WITHOUT_PLUS_SIGN' | 'FROM_DEFAULT_COUNTRY'
      - `extension` string — phone number extension
      - `isoCountryCode` string — ISO alpha-2 code
      - `italianLeadingZero` boolean
      - `nationalNumber` integer
      - `numberOfLeadingZeros` integer
      - `preferredDomesticCarrierCode` string
      - `rawInput` string
      - `type` 'UNKNOWN_TYPE' | 'MOBILE' | 'LANDLINE'
    - `email` string, required — Email of the traveler.
    - `loyaltyInfo` LoyaltyInfo — Loyalty Info details.
      - `appliedTo` string[]
      - `id` string, required
      - `issuedBy` string, required
      - `type` 'UNKNOWN_TYPE' | 'AIR' | 'HOTEL' | 'CAR' | 'RAIL', required
      - `linked` boolean — Indicates if this loyalty account is linked to the external provider. Only applicable for certain loyalty types.
      - `tier` string — Loyalty membership tier name echoed from the supplier.
    - `adhocInfo` object — Adhoc Info of the traveler. It is only present if the traveler is adhoc user.
      - `profileOwnerId` UserId — User identifier
        - `id` string, uuid, required
  - `tripData` TripData, required — Trip data to book a PNR.
    - `approverEmail` string — Email address of the approver who should receives approval email for the current booking.
    - `approverName` string — Name of the approver.
    - `hardApprovalRequired` boolean — Whether the current booking requires hard approval or soft approval. This flag should be used only if valid approver is present.
    - `outOfPolicy` boolean — If the given booking is out of policy.
    - `policyId` string — Policy Id for which violation is done.
    - `policyVersion` integer — Version of policy.
    - `tripId` TripId, required — Id of trip.
      - `id` string, required — Id.
  - `preBookAnswers` PreBookAnswers
    - `answers` EntityAnswer[]
      - `entityId` string — The unique ID for the question.
      - `userInput` string — The text input given by user (if any).
      - `itemIds` integer[] — The id/enum value corresponding to the option chosen by the user as answer.
      - `answers` AnswerPair[]
        - `item` string — The option selected from the list of available choices.
        - `value` string — The additional input provided (by the user) while selecting one of the options.
        - `description` string — Description of the selected option.
      - `customFieldType` 'QUESTION' | 'MEETING' | 'BUDGET' | 'BREX_TOKEN' — The type of custom field.
      - `questionDisplayText` string — The question text to be displayed to the user.
      - `question` Question — The message defines the format of a question which can be asked to a user in any kind of workflows.
        - `id` string, uuid, required
        - `name` string, required — Question display name that the user will see. For eg, 'Choose the purpose of your trip'.
        - `questionFormat` 'INPUT_BOX' | 'RADIO_BUTTON' | 'CHECKBOX' | 'CHECKBOX_WITH_PERCENTAGE' — Question types. INPUT_BOX will make user enter a free flowing text. RADIO_BUTTON will have multiple options, user can select only one. CHECKBOX questions contain the possible set of options, from which the user can choose multiple options. CHECKBOX_WITH_PERCENTAGE is similar to checkbox, with the difference being that each option having an additional input field whose values must add up to 100.
        - `optionInfo` OptionInfo — Options related information for the question.
          - `source` 'MANUAL' | 'COMPANY_CONFIG', required — Option source
          - `sourceMetadata` OptionSourceMetadata — Wrapper for option source company config.
            - `companyConfig` CompanyConfigSource — For this option source, options would be auto generated based on specified parameter.
              - …
          - `totalNumOptions` integer — Total number of options
          - `options` Option[] — Available options for the question. This will contain only max 10 options if only summary is requested.
            - `displayCode` string, required — The code which is sent in answer response.
            - `displayValue` string — The text to be displayed to the user beside this option.
        - `isRequired` boolean, required — Whether its compulsory to answer the question or not.
        - `isDisabled` boolean, required — Whether the question is disabled or not. If true, this should not be asked.
        - `includeInItinerary` boolean — Whether to include this question in the itinerary related emails.
        - `customFieldLocations` CustomFieldLocation[]
        - `matchConditions` CustomFieldMatchConditions — Conditions to select the custom field for given context.
          - `travelerConditions` TravelerMatchConditions — Matching conditions for traveler.
            - `workerTypes` WorkerType[] — Worker types. Users belonging to any of these would match.
            - `countries` string[] — Countries.
            - `legalEntities` Reference[] — Legal entities
              - …
            - `departments` Reference[] — Departments
              - …
            - `costCenters` Reference[] — Cost centers
              - …
            - `offices` Reference[] — Offices
              - …
          - `travelTypes` TravelType[] — Travel types to match.
          - `travelRegionTypes` TravelRegionType[] — Travel region types to match.
          - `tripUsageTypes` TripUsageType[] — Trip usage types to match. If empty, all trip usage types will be matched.
        - `questionType` QuestionType — Question type.
          - `preSearchQuestionType` 'UNKNOWN_SEARCH_QUESTION_TYPE' | 'PURPOSE_OF_TRIP' — Types of pre-search questions. PURPOSE_OF_TRIP required to ask purpose of the trip user is going to. For example: meeting, training, interview.
          - `preCheckoutQuestionType` 'UNKNOWN_CHECKOUT_QUESTION_TYPE' | 'USER_DEFINED_QUESTION' | 'OOP_REASON_CODE' — Types of pre-checkout questions. USER_DEFINED_QUESTION the default question type for all pre checkout questions which have been created from UI. OOP_REASON_CODE is kept separate so that existing OOP flow doesn't break.
    - `preBookQuestionResponseId` string — The unique id sent back in the pre book questions API response
  - `bookingPaymentDetails` BookingPaymentDetails, required — Payment details used for booking.
    - `bookingTravelerPaymentDetails` BookingTravelerPaymentDetails[], required
      - `selectedFormOfPayments` SelectedFormOfPayment[], required
        - `paymentItems` PaymentItem[], required
          - `itemType` 'SERVICE_FEE' | 'TRAVEL_TICKET' | 'SEAT' | 'BAGGAGE' | 'EARLY_BIRD' — Type of payment item eligible for this fop rule
          - `fareComponent` FareComponent[]
        - `selectedPaymentSources` SelectedPaymentSource[], required
          - `paymentSourceId` string, uuid — Unique identifier identifying this payment source.
          - `rawPaymentSource` union — Raw Details of the Payment Source
            - object — Object to pass through dpan payment source details through the api call.
              - …
            - object
              - …
          - `postPaymentRedirectionUrl` string — Url for post payment redirection if payment source navigates user to a third party url
          - `cvv` string — CVV associated with associated payment source, if any.
          - `amount` Money — Money object containing details such as the amount, the currency code, and the converted amount.
            - `amount` number, double, required — The numeric value for the amount of money.
            - `currencyCode` string, required — The 3-letter currency code for the money amount (defined using ISO 4217 standard).
            - `convertedAmount` number, double — The converted currency and amount that has been converted (if a currency conversion has been requested). For example, if the call requests that money be sent in a specified currency (because the frontend requested the backend to send money in the user's preferred currency).
            - `convertedCurrency` string — The 3-letter currency code for the converted currency (defined using ISO 4217 standard).
            - `otherCoinage` object[] — List of the dollar amount in other coinage systems like reward points, cryptocurrency etc.
              - …
  - `bookingContact` BookingContact, required
    - `emailAddress` string — Email address of the booking contact
    - `phoneNumber` PhoneNumber — Properly formatted phone number.
      - `countryCode` integer — two digit country code
      - `countryCodeSource` 'UNSPECIFIED' | 'FROM_NUMBER_WITH_PLUS_SIGN' | 'FROM_NUMBER_WITH_IDD' | 'FROM_NUMBER_WITHOUT_PLUS_SIGN' | 'FROM_DEFAULT_COUNTRY'
      - `extension` string — phone number extension
      - `isoCountryCode` string — ISO alpha-2 code
      - `italianLeadingZero` boolean
      - `nationalNumber` integer
      - `numberOfLeadingZeros` integer
      - `preferredDomesticCarrierCode` string
      - `rawInput` string
      - `type` 'UNKNOWN_TYPE' | 'MOBILE' | 'LANDLINE'
  - `hotelSpecialRequests` HotelSpecialRequests — Hotel special requests
    - `roomLocations` string[] — Room Location special request
    - `roomFeatures` string[] — Room Features List
    - `checkIn` 'EARLY_CHECK_IN' | 'LATE_CHECK_IN' — Early or Late Check-in
    - `checkInTime` TimeLocal — ISO8601 Local Time
      - `iso8601` string, required
    - `flightNumber` string — Attach flight number
    - `additionalNote` string — Free form text to describe special request
    - `accessibleFeatures` HotelAccessibleFeatureType[] — Accessible Features List
  - `cancelSourcePnrId` string — The source PNR ID within the booking source that needs to be canceled in favor of the new booking that is being created.
  - `hotelRateAssuranceInfo` HotelRateAssuranceMetadata — Savings information from the rate assurance rebooking
    - `selfReportedSavings` SimpleMoney — Money object containing just amount and currency code.
      - `amount` number, double, required — Amount
      - `currencyCode` string, required — The 3-letter currency code defined in ISO 4217.
    - `actualSavings` SimpleMoney — Money object containing just amount and currency code.
      - `amount` number, double, required — Amount
      - `currencyCode` string, required — The 3-letter currency code defined in ISO 4217.
  - `customFieldV3Responses` CustomFieldV3Response[] — Custom field responses for the booking.
    - `fieldId` string, uuid, required — Custom field id
    - `fieldName` string — Name of the custom field
    - `armId` string, uuid, required — Arm id which is applicable
    - `includeLocations` IncludeLocation[]
    - `selectedOptions` CustomFieldSelectedOption[], required — The list of options that are selected by user or auto populated.
      - `name` string, required — Value of the selection
      - `translatedName` string — Translated value of the selection
      - `description` string — Description of the selection
      - `translatedDescription` string — Translated description of the selection
      - `additionalUserInput` string — Additional user input
      - `additionalInfos` string[] — Actual values of the additional infos
      - `additionalInfoConfigs` AdditionalInfo[] — Additional info configs for the selected option
        - union — Additional data need to be sent along with the custom field response.
          - object — Variable defining the additional value to be sent along with custom field response.
            - `type` string, required
            - `name` 'PUBLISHED_FARE' | 'LLF' | 'ADD_COLLECT_AMOUNT' | 'SELECTED_FARE' | 'SPLIT_PAYMENT_FARE', required — Name of the variable.
          - object — Expression consisting of variables and constants which needs to be sent along with custom field response.
            - `type` string, required
            - `formatExpression` string, required — The expression must be of format : `<any_text> ${expression} <any_text>`.The expression can consist of a combination of variables and mathematical operations. Variable names must be same as VariableName Enum. To define mathematical operations, the operation name should follow the format `math.<math_op>(arg1, arg2)`. Both `arg1` and `arg2` can be variables or constants. The supported math operations (math_op) include: `add, mul, div, sub, min, and max`. All keywords, such as `<math_op>, math, and var` must be written in lowercase.
            - `variables` VariableName[] — Reference names of the variables present in the expression.
  - `ancillaryKeys` string[] — User selected ancillaries associated with this hotel booking.
  - `postPaymentVerificationInfo` union — Payment information sent after the verification of payment method.
    - object — Wrapper for post stripe verification info object.
      - `postStripeVerificationInfo` PostStripeVerificationInfo — Object to indicate successful stripe verification and provide payment information for next steps.
        - `paymentMethodId` string — Stripe's payment method id for which the verification was performed.
      - `paymentKey` string — Serialized key to identify the payment executed on payment gateway that will be used for post payment verification.
    - object — Wrapper for post url based verification info object.
      - `postUrlBasedVerificationInfo` PostUrlBasedVerificationInfo
        - `pnrId` string — Pnr Id, to continue with the booking flow/check the status of the pnr.
      - `paymentKey` string — Serialized key to identify the payment executed on payment gateway that will be used for post payment verification.
    - object — Wrapper for amadeus checkout verification info object
      - `amadeusCheckoutVerificationInfo` AmadeusCheckoutVerificationInfo
        - `paymentActionTokens` AmadeusPaymentActionToken[], required
          - `paymentRequestId` string, required — Initial payment id generated by checkout SDK to initiate payment
          - `actionToken` string, required — Token returned by checkout SDK to create/validate FOP in PSS order
        - `paymentRequestId` string — Initial payment id generated by checkout SDK to initiate payment
        - `actionToken` string — Token returned by checkout SDK to create/validate FOP in PSS order
        - `confirmPayment` boolean — Flag which indicates that the payment confirmation is now required (after 3ds or redirection)
      - `paymentKey` string — Serialized key to identify the payment executed on payment gateway that will be used for post payment verification.
    - object — Wrapper for 3DS2 post verification info object
      - `threeDSecure2PostVerificationInfo` ThreeDSecure2PostVerificationInfo — Result of 3DS2 verification.
        - `results` ThreeDSecure2VerificationResultItem[], required — List of 3DS2 verification results.
          - `cardId` string, required — Card id for which the verification was performed.
          - `sessionId` string, required — session id of the payment service provider.
          - `success` boolean, required — Whether the 3DSecure2 authentication was successful.
      - `paymentKey` string — Serialized key to identify the payment executed on payment gateway that will be used for post payment verification.
    - object — Wrapper for post razorpay verification info object.
      - `postRazorpayVerificationInfo` RazorpayPostVerificationInfo — Object to indicate successful stripe verification and provide payment information for next steps.
        - `paymentId` string, required — Razorpay payment id for which the verification was performed.
        - `orderId` string — Razorpay order id in which the payment was added.
        - `signature` string — Razorpay signature to validate the payment.
      - `paymentKey` string — Serialized key to identify the payment executed on payment gateway that will be used for post payment verification.

## Response `200`

OK

- HotelCreatePnrResponse — Defines the structure of a hotel create pnr response
  - `pnrId` string, required — A unique PNR ID created by Spotnana for the new hotel booking.
  - `pnrStatus` 'SUCCESS' | 'APPROVAL_PENDING' | 'CONFIRMATION_PENDING', required — The status of the PNR.
  - `externalPnrId` string — The external PNR ID for the hotel booking, created by the third party suppliers.
  - `paymentVerificationInfo` union — VerificationInfo required for the payment operation.
    - object — Wrapper for stripe verification Info.
      - `stripeVerificationInfo` StripeVerificationInfo — Verification information required for card stripe verification.
        - `stripeCardTokens` StripeCardTokens — Stripe card tokens used by clients in authorizing newly added cards.
          - `paymentProcessor` string, required — Payment processor involved.
          - `paymentMethodId` string, required — Stripe's payment-method-id for the card.
          - `setupIntentClientSecret` string, required — Stripe client secret for attaching the card to the setup-intent.
          - `connectedAccountId` string — Account Id of the connected account in which above payment-method and setup-intent exist. This is populated only when a connected account is used.
          - `publishableKey` string — Publishable key of the Stripe platform account.
      - `gatewayIdentifier` GatewayIdentifier
        - `gatewayId` string — Gateway Id for which the payment method should be verified.
        - `gatewayType` 'PAYMENT_GATEWAY_UNKNOWN' | 'STRIPE' | 'BREX' | 'RAZORPAY' — Gateway Type for of the verification gateway.
      - `paymentKey` string — Serialized key to identify the payment executed on payment gateway that will be used for post payment verification.
    - object — Wrapper for stripe verification Info.
      - `urlVerificationInfo` UrlVerificationInfo — Verification information required for url based payment verification.
        - `ccVerificationUrl` string — Verification url for the payment source.
      - `gatewayIdentifier` GatewayIdentifier
        - `gatewayId` string — Gateway Id for which the payment method should be verified.
        - `gatewayType` 'PAYMENT_GATEWAY_UNKNOWN' | 'STRIPE' | 'BREX' | 'RAZORPAY' — Gateway Type for of the verification gateway.
      - `paymentKey` string — Serialized key to identify the payment executed on payment gateway that will be used for post payment verification.
    - object — Wrapper for 3DS2 verification Info.
      - `threeDSecure2VerificationInfo` ThreeDSecure2VerificationInfo — Verification information required for 3DS2 authentication.
        - `verificationInfoList` ThreeDSecure2VerificationInfoItem[], required — List of 3DS2 verification info.
          - `cardId` string, required — Card id for which the verification was performed.
          - `sessionId` string, required — session id of the payment service provider.
          - `redirectUrl` string, required — 3DS2 verification redirect url.
      - `gatewayIdentifier` GatewayIdentifier
        - `gatewayId` string — Gateway Id for which the payment method should be verified.
        - `gatewayType` 'PAYMENT_GATEWAY_UNKNOWN' | 'STRIPE' | 'BREX' | 'RAZORPAY' — Gateway Type for of the verification gateway.
      - `paymentKey` string — Serialized key to identify the payment executed on payment gateway that will be used for post payment verification.
    - object — Wrapper for Razorpay verification Info.
      - `razorPayVerificationInfo` RazorpayVerificationInfo — Verification information required when card is tokenized via Razorpay for Indian markets.
        - `paymentProcessor` string, required — Payment processor involved.
        - `paymentAuthUrl` string — URL for authorizing the payment on the card.
      - `gatewayIdentifier` GatewayIdentifier
        - `gatewayId` string — Gateway Id for which the payment method should be verified.
        - `gatewayType` 'PAYMENT_GATEWAY_UNKNOWN' | 'STRIPE' | 'BREX' | 'RAZORPAY' — Gateway Type for of the verification gateway.
      - `paymentKey` string — Serialized key to identify the payment executed on payment gateway that will be used for post payment verification.

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — The specified resource was not found.

---

[API](https://skmtc.net/spotnana/apis/hotel-api.md) · [All operations](https://skmtc.net/spotnana/apis/hotel-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/spotnana/hotel-api/versions/4ad6bc6046c1/schema)