---
title: "Create a hotel booking and get the payment link"
method: POST
path: "/hotels/create-booking"
---

# Create a hotel booking and get the payment link

`POST /hotels/create-booking`

## Request

- Base URL: `https://www.fareeagle.com/api/v1`
- URL: `https://www.fareeagle.com/api/v1/hotels/create-booking`
- Auth: none declared

Guests per room (title, first_name, last_name, age; is_child for children), the contact (email, phone) and optional special_requests (requests[] from early_checkin, late_checkout, high_floor, quiet_room, non_smoking; bed any|king|twin; notes up to 200 characters, forwarded to the hotel and subject to availability). Returns the booking reference and a one-time payment_url valid for payment_expires_in seconds; the customer pays and accepts the terms on that page.

## Request body

- object
  - `booking_session` string, required
  - `guests` object[], required
    - `title` string
    - `first_name` string
    - `last_name` string
    - `age` integer
    - `is_child` boolean
  - `contact` object, required
    - `email` string
    - `phone` string
  - `special_requests` object
    - `requests` string[]
    - `bed` string
    - `notes` string

## Response `200`

booking_reference, payment_url, short_payment_url, payment_expires_in, total_amount, currency, cancellation_policy, hotel, checkin, checkout, guests

## Other responses

- `400`: Missing or invalid guest or contact fields
- `410`: The booking session has expired: prepare again

---

[API](https://skmtc.dev/fareeagle/apis/fareeagle-travel-api.md) · [All operations](https://skmtc.dev/fareeagle/apis/fareeagle-travel-api/llms.txt) · [OpenAPI document](https://skmtc.dev/fareeagle/apis/fareeagle-travel-api/revisions/b1611755038e?raw)