Create a reservation

Books a room for a date range. The range is half-open — checkout is not counted.

POST/reservations

Books a room for a date range. The range is half-open — checkout is not counted.

Request body

Required. Content type application/json.

{
  "guestName": "string",
  "checkIn": "2026-01-01",
  "checkOut": "2026-01-01",
  "roomType": "string"
}

Responses

Status	Description
`201`	Created.
`409`	No availability for that range.

Example response

{
  "id": "res_8f21",
  "status": "confirmed",
  "guestName": "string",
  "checkIn": "2026-01-01",
  "checkOut": "2026-01-01",
  "total": 0
}

Try it

curl -X POST "https://api.example.com/v1/reservations" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ }'