Reservations

Create a reservation

post/v1/reservations

Request

Base URL: https://api.frihet.io
URL: https://api.frihet.io/v1/reservations
Auth: API key in header X-API-Key

Request body

guestNamestring required

Guest full name

guestEmailstring email

propertyIdstring required

ID of the property

checkInstring date required

Check-in date (ISO 8601)

checkOutstring date required

Check-out date (ISO 8601)

status'Pending' | 'Confirmed' | 'Checked In' | 'Checked Out' | 'Cancelled'

amountnumber

Total amount in EUR

channel'Direct' | 'Airbnb' | 'Booking.com' | 'Vrbo'

confirmationCodestring

complianceStatus'Not Started' | 'In Progress' | 'Completed' | 'Failed'

nightsinteger

notesstring

Example request

{
  "guestName": "Maria Lopez",
  "guestEmail": "maria@example.com",
  "checkIn": "2026-05-01",
  "checkOut": "2026-05-05",
  "amount": 450,
  "channel": "Airbnb",
  "confirmationCode": "HM4X7K"
}

Response

Reservation created

idstring

guestNamestring

guestEmailstring nullable

propertyIdstring

checkInstring date-time

checkOutstring date-time

status'Pending' | 'Confirmed' | 'Checked In' | 'Checked Out' | 'Cancelled'

amountnumber

channelstring

confirmationCodestring nullable

complianceStatusstring

nightsinteger

notesstring nullable

createdAtstring date-time

updatedAtstring date-time

Changes

No recorded changes to this operation across all 1 revision of this API.