---
title: "Reservations search"
method: POST
path: "/occupations"
tags: ["PMS/CM endpoints"]
---

# Reservations search

`POST /occupations`

Synchronization of changes in reservations created by Termino/Slevomat. This allows changes in reservation made in PMS to be propagated to Termino and Slevomat. Changes can also be pushed via [/occupations-update](#tag/Termino-endpoints/operation/occupations-update) endpoint.
Usage:
  - synchronizing occupation changes once a day

## Request body

- object
  - `accessToken` string, required — Access token to your API.
  - `hotelId` union, required — Your hotel id.
    - string
    - integer
  - `interval` 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.
  - `roomTypeIds` union[] — Filter occupations on given room types.
    - union
      - string
      - integer

## Response `200`

Successful response

- OccupationsResponse
  - `occupations` Occupation[], required — List of matched occupations. Empty array if none found
    - `id` union, required — Your occupation id.
      - string
      - integer
    - `type` 'reservation', required — Type of occupation. `reservation` is only supported value
    - `status` string — Reservation status; optional and ignored for blockages.
    - `roomId` union — Your room id.
      - string
      - integer
    - `roomTypeId` union, required — Room type id.
      - string
      - integer
    - `created` string, date-time, required — Creation date and time in ISO 8601 format.
    - `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.

## 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)