---
title: "Reservation query"
method: POST
path: "/get-reservation"
tags: ["PMS/CM endpoints"]
---

# Reservation query

`POST /get-reservation`

Request for current state of the reservation

Usage:
- queried by Termino when a reservation disappears from synchronized interval (moved to another room, term, room deleted etc.) without being updated first (failsafe).

## Request body

- object
  - `accessToken` string, required — Access token to your API.
  - `hotelId` union, required — Hotel id.
    - string
    - integer
  - `reservationId` union, required — Reservation id.
    - string
    - integer

## Response `200`

Successful response

- Reservation
  - `id` union, required — Id of reservation.
    - string
    - integer
  - `status` 'option' | 'confirmed' | 'canceled' | 'modified', required — Reservation status.
  - `roomTypeId` union, required — Id of room type.
    - string
    - integer
  - `ratePlanId` union — Id of associated rate plan. Filled only if rate plans are set-up.
    - string
    - integer
  - `roomId` union — Id of room.
    - string
    - integer
  - `term` DateInterval, required — DateInterval is [start, end) – end date is exclusive.
    - `start` string, date, required — Start date in the format 'yyyy-mm-dd'.
    - `end` string, date, required — End date in the format 'yyyy-mm-dd'. Exclusive.
  - `price` Price, required
    - `amount` string, decimal, required — Money amount represented as decimal string with dot as decimal separator.
    - `currency` string, ISO 4271 currency code, required — Currency code.
  - `meal` 'none' | 'breakfast' | 'half_board' | 'full_board' | 'all_inclusive' — Meal type included in package.
  - `adultsCount` integer, required — Count of adults.
  - `childrenCount` integer — Count of children (with or without bed entitlement). This is deprecated, use children instead.
  - `children` object[], nullable — List of children ages and bed entitlement.
    - `age` integer — Age of child.
    - `bedEntitlement` boolean — Whether child is entitled to a separate bed.
  - `guestNote` string, nullable — Customers note related to reservation. May be an empty string.
  - `voucher` string, nullable — Slevomat voucher code for customer/hotel.
  - `contact` object — Contact to guest/customer.
    - `name` string, required — Contact person name.
    - `phone` string, required — Contact person phone number.
    - `email` string, required — Contact person email address.

## Other responses

- `400` — Expected error

---

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