> **Building with AI coding agents?** Install the authstack plugin with one command. This equips your agent with accurate Scalekit implementation patterns.
>
> **Recommended** (the `-y` flags skip prompts, so the command runs without an interactive terminal):
> ```bash
> npx -y @scalekit-inc/cli setup -y
> ```
>
> Global:
> ```bash
> npm install -g @scalekit-inc/cli
> scalekit setup -y
> ```
>
> Supports Claude Code, Cursor, GitHub Copilot, Codex + skills for other Agent Skills-compatible agents in `~/.agents/skills`.
> Skills: integrate-agentkit, implement-saaskit, add-mcp-oauth, implement-sso, implement-scim.
> [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/)

---

# Connect AI agents to Apaleo

The Apaleo connector lets your AI agent act in each user's Apaleo account. Each user signs in to Apaleo once, and Scalekit stores and refreshes their tokens, so your agent never handles credentials. It comes with 92 tools.

**Authentication:** OAuth 2.0
**Categories:** Productivity
**Tools:** 92: 55 read, 33 write, 4 destructive
**Users sign in with:** OAuth
**OAuth app:** Your own Apaleo app
**Built by:** Scalekit connector
**Try it:** [Playground in the Scalekit dashboard](https://app.scalekit.com/ws/signup?sk_intent=playground&provider=APALEO)

## Setup

1. ### Install the SDK

   **Node.js**

   ```bash
   npm install @scalekit-sdk/node dotenv
   ```

   **Python**

   ```bash
   pip install scalekit-sdk-python python-dotenv
   ```

2. ### Set your credentials

   Add your Scalekit credentials to your `.env` file. Find values in **[app.scalekit.com](https://app.scalekit.com)** > **Developers** > **API Credentials**.

   ```sh title=".env"
   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>
   ```

3. ### Create the Apaleo connection

   In **AgentKit > Connections**, create an Apaleo connection and copy its redirect URI. The name you give it is the `connection_name` your code passes. See [Configure connections](/agentkit/connections/).

4. ### Register an OAuth app

   Apaleo connections use your own OAuth app. Register one with Apaleo and add the redirect URI you copied.

   Then enter the app's Client ID and Client Secret on the Apaleo connection.

5. ### Authorize a user and make your first call

   **Node.js** (`quickstart.mts`)

   ```typescript
   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   import { createInterface } from 'node:readline/promises'

   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENVIRONMENT_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions

   const connector = 'apaleo'
   const identifier = 'user_123'

   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize Apaleo:', link)
   const rl = createInterface({ input: process.stdin, output: process.stdout })
   await rl.question('Press Enter after authorizing...')
   rl.close()

   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'apaleo_count_properties',
     toolInput: {},
   })
   console.log(result)
   ```

   ```bash
   npx tsx quickstart.mts
   ```

   **Python** (`quickstart.py`)

   ```python
   import os
   from scalekit import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()

   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions

   connection_name = "apaleo"
   identifier = "user_123"

   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize Apaleo:", link_response.link)
   input("Press Enter after authorizing...")

   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="apaleo_count_properties",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)
   ```

   ```bash
   python quickstart.py
   ```

   Each user signs in once. See [Authorize a user](/agentkit/tools/authorize/) for the full flow and statuses.

## Tools

Pass the exact name to `execute_tool`, with an input like each tool's example. To ask for a tool that's missing, use the [request form](https://scalekitsupport.portal.usepylon.com/forms/request-a-connector-tool).

**Node.js**

```typescript
const result = await actions.executeTool({
  toolName: 'apaleo_count_properties',
  toolInput: {},
  connector: 'apaleo',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="apaleo_count_properties",
    tool_input={},
    connection_name="apaleo",
    identifier="user_123",
)
```

`result.data` is the app's response as JSON, and `result.execution_id` (`executionId` in Node.js) is the ID of the call.

### `apaleo_count_properties`

Count Properties · Read-only

Count the properties in the account.
Returns an object with `count`.
Use when only the number of properties matters. Use list_properties for the records.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `apaleo_count_reservations`

Count Reservations · Read-only

Count reservations matching the filters.
Returns an object with `count`.
Use when only the total matters.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `allFoliosHaveInvoice` (`boolean`, optional): If set to `true`, returns only reservations, in which all folios are closed and have an invoice. If set to `false`, returns only reservations, in which some of the folios are open or don't have an invoice
- `balanceFilter` (`string`, optional): This will filter reservations based on their balance. You can provide an array of string expressions which all need to apply. Each expression has the form of 'OPERATION_VALUE' where VALUE needs to be of the valid format of the property type and OPERATION can be: 'eq' for equals 'neq' for not equals 'lt' for less than 'gt' for greater than 'lte' for less than or equals 'gte' for greater than or equals For instance 'eq_5' would mean the value should equal 5 'lte_7' would mean... Comma-separated list.
- `blockIds` (`string`, optional): Filter result by requested blocks Comma-separated list.
- `bookingId` (`string`, optional): Filter result by booking id
- `channelCode` (`string`, optional): Filter result by the channel code Comma-separated list of: Direct, BookingCom, Ibe, ChannelManager, Expedia, Homelike, Hrs, AltoVita, DesVu, Gimsi.
- `companyIds` (`string`, optional): Filter result by requested companies Comma-separated list.
- `dateFilter` (`string`, optional): Filter by date and time attributes of reservation. Use in combination with the 'To' and 'From' attributes. All filters will check if the date specified by the filter type is between from (included) and to (excluded). The exception being filtering for 'stay', which will return all reservations that are overlapping with the interval specified by from and to. One of: `Arrival`, `Departure`, `Stay`, `Creation`, `Modification`, `Cancellation`, `ArrivalAndCheckIn`, `DepartureAndCheckOut`.
- `externalCode` (`string`, optional): Filter result by the external code. The result set will contain all reservations that have an external code starting with the provided value
- `externalReferences` (`string`, optional): This will filter all reservation where the provided external references have an exact match on at least one of the properties in Apaleo.Api.Modules.Booking.Models.Reservation.ExternalReferencesModel Comma-separated list.
- `from` (`string`, optional): The start of the time interval. When filtering by date, at least one of 'from' and 'to' has to be specified A date and time (without fractional second part) in UTC or with UTC offset as defined in ISO8601:2004
- `hasActivePaymentAccount` (`boolean`, optional): If set to `true`, returns only the reservations with an active payment account. If set to `false`, returns only the reservations without an active payment account.
- `isPreCheckedIn` (`boolean`, optional): If set to `true`, returns only the reservations marked as pre-checked-in. If set to `false`, returns only the reservations not marked as pre-checked-in.
- `marketSegmentIds` (`string`, optional): Filter result by requested market segments Comma-separated list.
- `propertyIds` (`string`, optional): Filter result by requested properties Comma-separated list.
- `ratePlanIds` (`string`, optional): Filter result by requested rate plans Comma-separated list.
- `sources` (`string`, optional): Filter result by source Comma-separated list.
- `status` (`string`, optional): Filter result by reservation status Comma-separated list of: Confirmed, InHouse, CheckedOut, Canceled, NoShow.
- `textSearch` (`string`, optional): Filters reservations by searching for the provided text across multiple fields. The search is case-insensitive and includes: - Booker information (first name, last name, email, company name) - Primary guest information (first name, last name, email, company name) - Additional guest information (first name, last name, email, company name) - Reservation details (external code, external references, reservation ID) - Unit name - Group name
- `to` (`string`, optional): The end of the time interval, must be larger than 'from'. When filtering by date, at least one of 'from' and 'to' has to be specified A date and time (without fractional second part) in UTC or with UTC offset as defined in ISO8601:2004
- `unitGroupIds` (`string`, optional): Filter result by requested unit groups Comma-separated list.
- `unitGroupTypes` (`string`, optional): Filter result by requested unit group types Comma-separated list of: BedRoom, MeetingRoom, EventSpace, ParkingLot, Other.
- `unitIds` (`string`, optional): Filter result by assigned units Comma-separated list.
- `validationMessageCategory` (`string`, optional): Filter result by validation message category Comma-separated list of: OfferNotAvailable, AutoUnitAssignment, GuestLoyalty.

Example input: `{}`

### `apaleo_get_arrivals_report`

Get Arrivals Report · Read-only

Get the arrivals and departures report for a property over a date range.
Returns an object with `total`, `totalAdults`, `totalChildren`, `travelPurposeBreakdown`, `nationalityBreakdown`, `countryOfResidenceBreakdown`.
Use for front-desk planning.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `month` (`integer`, required): Requested month for the report.
- `propertyId` (`string`, required): Requested property.
- `year` (`integer`, required): Requested year for the report.

Example input: `{"month":1,"propertyId":"<propertyId>","year":1}`

### `apaleo_get_block`

Get Block · Read-only

Get one room block by its id.
Returns an object with `id`, `group`, `status`, `property`, `ratePlan`, `unitGroup`, `grossDailyRate` and more.
Use after list_blocks for details.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `blockId` (`string`, required): Id of the block to be retrieved.
- `expand` (`string`, optional): List of all embedded resources that should be expanded in the response. Possible values are: actions, timeSlices. All other values will be silently ignored. Comma-separated list of: actions, timeSlices.

Example input: `{"blockId":"<blockId>"}`

### `apaleo_get_booking`

Get Booking · Read-only

Get one booking, including its booker and reservations.
Returns an object with `id`, `groupId`, `booker`, `paymentAccount`, `hasActivePaymentAccount`, `registeredCard`, `comment` and more.
Use after list_bookings for the full booking.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `bookingId` (`string`, required): Id of the booking to be retrieved.
- `expand` (`string`, optional): List of all embedded resources that should be expanded in the response. Possible values are: property, unitGroup, ratePlan, services, reservations, propertyValues. All other values will be silently ignored. Comma-separated list of: property, unitGroup, ratePlan, services, reservations, propertyValues.

Example input: `{"bookingId":"<bookingId>"}`

### `apaleo_get_company`

Get Company · Read-only

Get one company by its id.
Returns an object with `id`, `code`, `propertyId`, `name`, `invoicingEmail`, `phone`, `taxId` and more.
Use after list_companies for a single company's details.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `companyId` (`string`, required): The ID of the company.

Example input: `{"companyId":"<companyId>"}`

### `apaleo_get_current_account`

Get Current Account · Read-only

Get the Apaleo account the connected user belongs to.
Returns an object with `code`, `name`, `description`, `defaultLanguage`, `logoUrl`, `location`, `type` and more.
Use first to confirm which account is connected.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `apaleo_get_folio`

Get Folio · Read-only

Get one folio with its charges, payments and balance.
Returns an object with `id`, `created`, `updated`, `type`, `debitor`, `closingDate`, `reservation` and more.
Use after list_folios for the full bill.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `folioId` (`string`, required): The ID of the folio.
- `expand` (`string`, optional): List of all embedded resources that should be expanded in the response. Possible values are: folios. All other values will be silently ignored. Comma-separated list of: folios.

Example input: `{"folioId":"<folioId>"}`

### `apaleo_get_group`

Get Group Booking · Read-only

Get one group booking by its id.
Returns an object with `id`, `name`, `from`, `to`, `booker`, `comment`, `bookerComment` and more.
Use after list_groups for details.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `groupId` (`string`, required): Id of the group booking to be retrieved.
- `expand` (`string`, optional): List of all embedded resources that should be expanded in the response. Possible values are: blocks, actions. All other values will be silently ignored. Comma-separated list of: blocks, actions.

Example input: `{"groupId":"<groupId>"}`

### `apaleo_get_invoice`

Get Invoice · Read-only

Get one invoice by its id.
Returns an object with `id`, `number`, `type`, `series`, `to`, `paymentSettled`, `status` and more.
Use after list_invoices for details.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `invoiceId` (`string`, required): The invoice ID.
- `expand` (`string`, optional): List of all embedded resources that should be expanded in the response. Possible values are: company. All other values will be silently ignored. Comma-separated list of: company.

Example input: `{"invoiceId":"<invoiceId>"}`

### `apaleo_get_maintenance`

Get Maintenance · Read-only

Get one maintenance task by its id.
Returns an object with `id`, `unit`, `from`, `to`, `type`, `description`.
Use after list_maintenances for details.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `maintenanceId` (`string`, required): The ID of the maintenance.
- `expand` (`string`, optional): List of all embedded resources that should be expanded in the response. Possible values are: unit. All other values will be silently ignored. Comma-separated list of: unit.

Example input: `{"maintenanceId":"<maintenanceId>"}`

### `apaleo_get_property`

Get Property · Read-only

Get one property by its id, including address, currency and time zone.
Returns an object with `id`, `code`, `propertyTemplateId`, `isTemplate`, `name`, `description`, `companyName` and more.
Use after list_properties when you need details of a single property.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `propertyId` (`string`, required): The id of the property.
- `expand` (`string`, optional): List of all embedded resources that should be expanded in the response. Possible values are: actions. All other values will be silently ignored. Comma-separated list of: actions.
- `languages` (`string`, optional): 'all' or comma separated list of two-letter language codes (ISO Alpha-2) Comma-separated list.

Example input: `{"propertyId":"<propertyId>"}`

### `apaleo_get_property_availability`

Get Property Availability · Read-only

Get house-level overbooking settings for a property.
Returns an object with `timeSlices`, `count`.
Use to read the overbooking limit of a property.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `from` (`string`, required): The first day of the time period from which availability will be modified.
- `propertyId` (`string`, required): The ID of the property.
- `timeSliceTemplate` (`string`, required): The time slice template. One of: `DayUse`, `OverNight`.
- `to` (`string`, required): The last day of the time period until which availability will be modified.
- `unitGroupType` (`string`, required): The unit group type. One of: `BedRoom`, `MeetingRoom`, `EventSpace`, `ParkingLot`, `Other`.

Example input: `{"from":"<from>","propertyId":"<propertyId>","timeSliceTemplate":"DayUse","to":"<to>","unitGroupType":"BedRoom"}`

### `apaleo_get_property_performance_report`

Get Property Performance Report · Read-only

Get occupancy, ADR and RevPAR figures for a property over a date range.
Returns an object with `houseCount`, `houseItemsCount`, `soldCount`, `soldItemsCount`, `unsoldCount`, `unsoldItemsCount`, `outOfOrderCount` and more.
Use for performance summaries.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `from` (`string`, required): The inclusive start date of the interval
- `propertyId` (`string`, required): The ID of the property
- `to` (`string`, required): The inclusive end date of the interval
- `channelCodes` (`string`, optional): The channel codes used to filter the retrieved data Comma-separated list of: Direct, BookingCom, Ibe, ChannelManager, Expedia, Homelike, Hrs, AltoVita, DesVu, Gimsi.
- `companyIds` (`string`, optional): The company IDs used to filter the retrieved data Comma-separated list.
- `expand` (`string`, optional): List of all embedded resources that should be expanded in the response. Possible values are: businessDays. All other values will be silently ignored. Comma-separated list of: businessDays.
- `marketSegmentIds` (`string`, optional): The market segment IDs used to filter the retrieved data Comma-separated list.
- `ratePlanIds` (`string`, optional): The rate plan IDs used to filter the retrieved data Comma-separated list.
- `sources` (`string`, optional): The sources used to filter the retrieved data Comma-separated list.
- `timeSliceDefinitionIds` (`string`, optional): The time slice definition IDs used to filter the retrieved data Comma-separated list.
- `travelPurpose` (`string`, optional): The travel purpose to filter the retrieved data. One of: `Business`, `Leisure`.
- `unitGroupIds` (`string`, optional): The unit group IDs used to filter the retrieved data Comma-separated list.
- `unitGroupTypes` (`string`, optional): The unit group types used to filter the retrieved data Comma-separated list of: BedRoom, MeetingRoom, EventSpace, ParkingLot, Other.

Example input: `{"from":"<from>","propertyId":"<propertyId>","to":"<to>"}`

### `apaleo_get_property_settings`

Get Property Settings · Read-only

Get the settings of a property such as check-in times and policies.
Returns an object with `timeZone`, `currency`.
Use to read configuration rather than inventory data.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `propertyId` (`string`, required): The id of the property.

Example input: `{"propertyId":"<propertyId>"}`

### `apaleo_get_rate_plan`

Get Rate Plan · Read-only

Get one rate plan by its id.
Returns an object with `id`, `code`, `name`, `description`, `minGuaranteeType`, `priceCalculationMode`, `property` and more.
Use after list_rate_plans for details of a single rate plan.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `ratePlanId` (`string`, required): The id of the rate plan.
- `expand` (`string`, optional): List of all embedded resources that should be expanded in the response. Possible values are: property, cancellationPolicy. All other values will be silently ignored. Comma-separated list of: property, cancellationPolicy.
- `languages` (`string`, optional): 'all' or comma separated list of two-letter language codes (ISO Alpha-2) Comma-separated list.

Example input: `{"ratePlanId":"<ratePlanId>"}`

### `apaleo_get_reservation`

Get Reservation · Read-only

Get one reservation with guest, stay, price and unit details.
Returns an object with `id`, `bookingId`, `blockId`, `groupName`, `status`, `checkInTime`, `checkOutTime` and more.
Use after list_reservations for a single stay.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `reservationId` (`string`, required): Id of the reservation to be retrieved.
- `expand` (`string`, optional): List of all embedded resources that should be expanded in the response. Possible values are: timeSlices, services, booker, actions, company, assignedUnits. All other values will be silently ignored. Comma-separated list of: timeSlices, services, booker, actions, company, assignedUnits.

Example input: `{"reservationId":"<reservationId>"}`

### `apaleo_get_revenues_report`

Get Revenues Report · Read-only

Get revenue totals by account for a property over a date range.
Returns an object with `account`, `netAmount`, `grossAmount`, `children`.
Use for revenue breakdowns.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `from` (`string`, required): The inclusive start date of the interval.
- `propertyId` (`string`, required): Property ID
- `to` (`string`, required): The exclusive end date of the interval. The interval is limited to one year.
- `languageCode` (`string`, optional): The language for the the report

Example input: `{"from":"<from>","propertyId":"<propertyId>","to":"<to>"}`

### `apaleo_get_service`

Get Service · Read-only

Get one service by its id.
Returns an object with `id`, `code`, `name`, `description`, `defaultGrossPrice`, `pricingUnit`, `postNextDay` and more.
Use after list_services for details of a single service.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `serviceId` (`string`, required): The id of the service.
- `expand` (`string`, optional): List of all embedded resources that should be expanded in the response. Possible values are: property. All other values will be silently ignored. Comma-separated list of: property.
- `languages` (`string`, optional): 'all' or comma separated list of two-letter language codes (ISO Alpha-2) Comma-separated list.

Example input: `{"serviceId":"<serviceId>"}`

### `apaleo_get_unit`

Get Unit · Read-only

Get one unit by its id.
Returns an object with `id`, `name`, `description`, `property`, `unitGroup`, `connectingUnit`, `status` and more.
Use after list_units for a single unit's details.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `unitId` (`string`, required): The id of the unit.
- `expand` (`string`, optional): List of all embedded resources that should be expanded in the response. Possible values are: property, unitGroup, connectedUnits, actions. All other values will be silently ignored. Comma-separated list of: property, unitGroup, connectedUnits, actions.
- `languages` (`string`, optional): 'all' or comma separated list of two-letter language codes (ISO Alpha-2) Comma-separated list.

Example input: `{"unitId":"<unitId>"}`

### `apaleo_get_unit_group`

Get Unit Group · Read-only

Get one unit group by its id.
Returns an object with `id`, `code`, `property`, `name`, `memberCount`, `description`, `maxPersons` and more.
Use after list_unit_groups for a single room type's details.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `unitGroupId` (`string`, required): The id of the unit group.
- `expand` (`string`, optional): List of all embedded resources that should be expanded in the response. Possible values are: property, connectedUnitGroups. All other values will be silently ignored. Comma-separated list of: property, connectedUnitGroups.
- `languages` (`string`, optional): 'all' or comma separated list of two-letter language codes (ISO Alpha-2) Comma-separated list.

Example input: `{"unitGroupId":"<unitGroupId>"}`

### `apaleo_list_available_services`

List Available Services · Read-only

List the availability of services in a property over a time range.
Returns an object with `timeSlices`, `count`.
Use for services with limited capacity.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `from` (`string`, required): First day of the requested time period. The given day will be included in the response.
- `propertyId` (`string`, required): The property id
- `to` (`string`, required): Last day of the requested time period. The given day will be included in the response.
- `channelCodes` (`string`, optional): The channel code used to filter the services Comma-separated list of: Direct, BookingCom, Ibe, ChannelManager, Expedia, Homelike, Hrs, AltoVita, DesVu, Gimsi.
- `pageNumber` (`integer`, optional): Page number to retrieve. Default: 1. If the page has no items, the API returns 204 No Content.
- `pageSize` (`integer`, optional): Items per page. Default: 500. Maximum: 500.
- `timeSliceDefinitionIds` (`string`, optional): The time slice definition ids Comma-separated list.
- `timeSliceTemplate` (`string`, optional): The time slice template, defaults to 'over night'. One of: `DayUse`, `OverNight`.

Example input: `{"from":"<from>","propertyId":"<propertyId>","to":"<to>"}`

### `apaleo_list_available_unit_groups`

List Available Unit Groups · Read-only

List the availability of unit groups (room types) in a property over a time range.
Returns an object with `timeSlices`, `count`.
Use to check how many rooms of each type are free.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `from` (`string`, required): First day of the requested time period. The given day will be included in the response.
- `propertyId` (`string`, required): The property id
- `to` (`string`, required): Last day of the requested time period. The given day will be included in the response.
- `adults` (`integer`, optional): The number of adults you want availability for, defaults to 1
- `childrenAges` (`string`, optional): The ages of the children you want availability for Comma-separated list.
- `onlySellable` (`boolean`, optional): When set to 'true', only the unit groups sold by the specified time slice template and time slice definition ids are returned, otherwise all unit groups are returned
- `pageNumber` (`integer`, optional): Page number to retrieve. Default: 1. If the page has no items, the API returns 204 No Content.
- `pageSize` (`integer`, optional): Items per page. Default: 500. Maximum: 500.
- `timeSliceDefinitionIds` (`string`, optional): The time slice definition ids Comma-separated list.
- `timeSliceTemplate` (`string`, optional): The time slice template, defaults to 'over night'. One of: `DayUse`, `OverNight`.
- `unitGroupIds` (`string`, optional): The unit group ids Comma-separated list.
- `unitGroupTypes` (`string`, optional): Filter result by requested unit group types Comma-separated list of: BedRoom, MeetingRoom, EventSpace, ParkingLot, Other.

Example input: `{"from":"<from>","propertyId":"<propertyId>","to":"<to>"}`

### `apaleo_list_available_units`

List Available Units · Read-only

List units available for a property in a time range.
Returns an object with `units`, `count`.
Use to check which specific rooms are free. Use list_available_unit_groups for room-type availability.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `from` (`string`, required): The from date and time A date and time (without fractional second part) in UTC or with UTC offset as defined in ISO8601:2004
- `propertyId` (`string`, required): The property id
- `to` (`string`, required): The to date and time A date and time (without fractional second part) in UTC or with UTC offset as defined in ISO8601:2004
- `includeOutOfService` (`boolean`, optional): Should units that are set OutOfService in the defined time period be returned as available.
- `pageNumber` (`integer`, optional): Page number to retrieve. Default: 1. If the page has no items, the API returns 204 No Content.
- `pageSize` (`integer`, optional): Items per page. Default: 500. Maximum: 500.
- `unitAttributeIds` (`string`, optional): Return units with the specific unit attributes Comma-separated list.
- `unitCondition` (`string`, optional): The unit condition. One of: `Clean`, `CleanToBeInspected`, `Dirty`.
- `unitGroupId` (`string`, optional): The unit group id

Example input: `{"from":"<from>","propertyId":"<propertyId>","to":"<to>"}`

### `apaleo_list_blocks`

List Blocks · Read-only

List room blocks held for groups.
Returns an object with `blocks`, `count`.
Use to see blocked inventory.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `expand` (`string`, optional): List of all embedded resources that should be expanded in the response. Possible values are: actions, timeSlices. All other values will be silently ignored. Comma-separated list of: actions, timeSlices.
- `from` (`string`, optional): The start of the time range. All blocks that are overlapping with the interval specified by from and to will be returned A date and time (without fractional second part) in UTC or with UTC offset as defined in ISO8601:2004
- `groupId` (`string`, optional): Return blocks for the specific group
- `pageNumber` (`integer`, optional): Page number to retrieve. Default: 1. If the page has no items, the API returns 204 No Content.
- `pageSize` (`integer`, optional): Items per page. Default: 500. Maximum: 500.
- `propertyIds` (`string`, optional): Return blocks filtered by properties Comma-separated list.
- `ratePlanIds` (`string`, optional): Return blocks with any of the specified rate plans Comma-separated list.
- `status` (`string`, optional): Return blocks filtered by statuses Comma-separated list of: Tentative, Definite, Canceled, Optional.
- `timeSliceDefinitionIds` (`string`, optional): Return blocks with any of the specified time slice definitions Comma-separated list.
- `timeSliceTemplate` (`string`, optional): The time slice template, defaults to 'over night'. One of: `DayUse`, `OverNight`.
- `to` (`string`, optional): The end of the time range. All blocks that are overlapping with the interval specified by from and to will be returned A date and time (without fractional second part) in UTC or with UTC offset as defined in ISO8601:2004
- `unitGroupIds` (`string`, optional): Return blocks with any of the specified unit groups Comma-separated list.
- `unitGroupTypes` (`string`, optional): Return blocks with any of the specified unit group types Comma-separated list of: BedRoom, MeetingRoom, EventSpace, ParkingLot, Other.

Example input: `{}`

### `apaleo_list_booking_sources`

List Booking Sources · Read-only

List the booking source values that reservations can use.
Returns an object with `sources`.
Use to pick a valid source when creating a booking.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `apaleo_list_bookings`

List Bookings · Read-only

List bookings, filtered by property, guest, dates or status.
Returns an object with `bookings`, `count`.
Use to find a booking. Use list_reservations to work at the individual stay level.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `bookingIds` (`string`, optional): Filter result by booking id. Returns only the bookings matching the specified ids Comma-separated list.
- `channelCode` (`string`, optional): Filter result by the channel code. The resul set will contain all bookings having reservations with the specified channel code Comma-separated list of: Direct, BookingCom, Ibe, ChannelManager, Expedia, Homelike, Hrs, AltoVita, DesVu, Gimsi.
- `expand` (`string`, optional): List of all embedded resources that should be expanded in the response. Possible values are: property, unitGroup, ratePlan, services, reservations. All other values will be silently ignored. Comma-separated list of: property, unitGroup, ratePlan, services, reservations.
- `externalCode` (`string`, optional): Filter result by the external code. The result set will contain all bookings having reservations with external code starting with provided value
- `groupId` (`string`, optional): Filter result by group id. The result set will contain all bookings having groups with the specified id
- `hasActivePaymentAccount` (`boolean`, optional): If set to `true`, returns only the bookings with an active payment account. If set to `false`, returns only the bookings without an active payment account.
- `pageNumber` (`integer`, optional): Page number to retrieve. Default: 1. If the page has no items, the API returns 204 No Content.
- `pageSize` (`integer`, optional): Items per page. Default: 500. Maximum: 500.
- `reservationId` (`string`, optional): Filter result by reservation id. The result set will contain all bookings having reservations with the specified id
- `textSearch` (`string`, optional): This will filter all bookings for the provided free text. Currently it only looks up if either the lastname, firstname, email or company name of the booker contains one of the provided values

Example input: `{}`

### `apaleo_list_cancellation_policies`

List Cancellation Policies · Read-only

List cancellation policies defined for properties.
Returns an object with `cancellationPolicies`, `count`.
Use to find policy ids for rate plans.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `pageNumber` (`integer`, optional): Page number to retrieve. Default: 1. If the page has no items, the API returns 204 No Content.
- `pageSize` (`integer`, optional): Items per page. Default: 500. Maximum: 500.
- `propertyId` (`string`, optional): Filter cancellation policies by the specified property

Example input: `{}`

### `apaleo_list_city_taxes`

List City Taxes · Read-only

List city tax definitions.
Returns an object with `cityTaxes`, `count`.
Use to read tax setup per property.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `propertyId` (`string`, optional): Filter by the specified property

Example input: `{}`

### `apaleo_list_companies`

List Companies · Read-only

List companies (corporate customers) with their negotiated rates.
Returns an object with `companies`, `count`.
Use to find company ids or search by name or code.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `corporateCodes` (`string`, optional): Return companies that have any of the requested corporate codes. Comma-separated list.
- `pageNumber` (`integer`, optional): Page number to retrieve. Default: 1. If the page has no items, the API returns 204 No Content.
- `pageSize` (`integer`, optional): Items per page. Default: 500. Maximum: 500.
- `propertyId` (`string`, optional): Filter by the specified property
- `ratePlanIds` (`string`, optional): Return companies with any of the specified rate plans Comma-separated list.
- `textSearch` (`string`, optional): This will filter all companies for the provided free text. Currently it only looks up if the company name contains one of the provided values

Example input: `{}`

### `apaleo_list_currencies`

List Currencies · Read-only

List the currency codes supported by Apaleo.
Returns an object with `isoCurrencies`.
Use to validate currency input.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `apaleo_list_folio_payments`

List Folio Payments · Read-only

List the payments posted on a folio.
Returns an object with `payments`, `count`.
Use to see what a guest paid.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `folioId` (`string`, required): Id of the folio.
- `expand` (`string`, optional): List of all embedded resources that should be expanded in the response. Possible values are: actions. All other values will be silently ignored. Comma-separated list of: actions.
- `pageNumber` (`integer`, optional): Page number to retrieve. Default: 1. If the page has no items, the API returns 204 No Content.
- `pageSize` (`integer`, optional): Items per page. Default: 500. Maximum: 500.
- `statusCodes` (`string`, optional): Filter payments by one or more status. Comma-separated list of: Pending, Success, Failure, Canceled.

Example input: `{"folioId":"<folioId>"}`

### `apaleo_list_folio_refunds`

List Folio Refunds · Read-only

List the refunds on a folio.
Returns an object with `refunds`, `count`.
Use to see refunds issued to a guest.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `folioId` (`string`, required): Id of the folio.
- `pageNumber` (`integer`, optional): Page number to retrieve. Default: 1. If the page has no items, the API returns 204 No Content.
- `pageSize` (`integer`, optional): Items per page. Default: 500. Maximum: 500.
- `statusCodes` (`string`, optional): Filter refunds by one or more status Comma-separated list of: Pending, Success, Failure, Canceled.

Example input: `{"folioId":"<folioId>"}`

### `apaleo_list_folios`

List Folios · Read-only

List guest folios filtered by reservation, booking, company or status.
Returns an object with `folios`, `count`.
Use to find the bill of a stay.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `balanceFilter` (`string`, optional): This will filter reservations based on their balance. You can provide an array of string expressions which all need to apply. Each expression has the form of 'OPERATION_VALUE' where VALUE needs to be of the valid format of the property type and OPERATION can be: 'eq' for equals 'neq' for not equals 'lt' for less than 'gt' for greater than 'lte' for less than or equals 'gte' for greater than or equals For instance 'eq_5' would mean the value should equal 5 'lte_7' would mean... Comma-separated list.
- `bookingIds` (`string`, optional): Filter folio list by booking IDs Comma-separated list.
- `companyIds` (`string`, optional): Filter folio list by company IDs Comma-separated list.
- `createdFrom` (`string`, optional): The inclusive start time of the date of creation. Mostly useful for external folios A date and time (without fractional second part) in UTC or with UTC offset as defined in ISO8601:2004
- `createdTo` (`string`, optional): The exclusive end time of the date of creation. Mostly useful for external folios A date and time (without fractional second part) in UTC or with UTC offset as defined in ISO8601:2004
- `excludeClosed` (`boolean`, optional): If set to `true`, closed folios are filtered out from the result collection - DEPRECATED: This field will be removed soon. Please use Status=Open instead.
- `expand` (`string`, optional): List of all embedded resources that should be expanded in the response. Possible values are: allowances, allowedActions, transitoryCharges, charges, company, payments, warnings. All other values will be silently ignored. Comma-separated list of: allowances, allowedActions, transitoryCharges, charges, company, payments, warnings.
- `externalFolioCode` (`string`, optional): Allows filtering external folios by code. Useful when you use external folios with custom codes. Specifying this parameter will ignore the Type parameter and treat as if it would be set to "External" instead.
- `hasInvoices` (`boolean`, optional): If set to `true`, only folios with invoices are returned. If set to `false`, only folios without invoices are returned. If omitted/`null`, all folios are returned.
- `isEmpty` (`boolean`, optional): If set to `true`, only return empty folios (no unmoved [transitory] charges, no unmoved payments, no allowances). If set to `false`, only return non-empty folios
- `onlyMain` (`boolean`, optional): If set to `true`, only main folios are returned, otherwise all.
- `pageNumber` (`integer`, optional): Page number to retrieve. Default: 1. If the page has no items, the API returns 204 No Content.
- `pageSize` (`integer`, optional): Items per page. Default: 500. Maximum: 500.
- `propertyIds` (`string`, optional): Filter folio list by property IDs Comma-separated list.
- `reservationIds` (`string`, optional): Filter folio list by reservation IDs Comma-separated list.
- `sort` (`string`, optional): List of all fields that can be used to sort the results. Possible values are: created:asc, created:desc, balance:asc, balance:desc. All other values will be silently ignored. Comma-separated list of: created:asc, created:desc, balance:asc, balance:desc.
- `status` (`string`, optional): The status of the folio. One of: `Open`, `Closed`.
- `textSearch` (`string`, optional): This will filter all folios where the provided text is contained in: debitor first name or last name or company name, folio id. The search is case insensitive.
- `type` (`string`, optional): The type of the folio. One of: `House`, `Guest`, `External`, `Booking`.
- `updatedFrom` (`string`, optional): The inclusive start time of the date of the last update. Mostly useful for external folios A date and time (without fractional second part) in UTC or with UTC offset as defined in ISO8601:2004
- `updatedTo` (`string`, optional): The exclusive end time of the date of the last update. Mostly useful for external folios A date and time (without fractional second part) in UTC or with UTC offset as defined in ISO8601:2004

Example input: `{}`

### `apaleo_list_groups`

List Group Bookings · Read-only

List group bookings.
Returns an object with `groups`, `count`.
Use to find group ids. Use list_blocks for room blocks.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `expand` (`string`, optional): List of all embedded resources that should be expanded in the response. Possible values are: blocks, actions. All other values will be silently ignored. Comma-separated list of: blocks, actions.
- `from` (`string`, optional): The start of the time range. All groups that have blocks overlapping with the interval specified by from and to will be returned A date and time (without fractional second part) in UTC or with UTC offset as defined in ISO8601:2004
- `hasActivePaymentAccount` (`boolean`, optional): If set to `true`, returns only the groups with an active payment account. If set to `false`, returns only the groups without an active payment account.
- `pageNumber` (`integer`, optional): Page number to retrieve. Default: 1. If the page has no items, the API returns 204 No Content.
- `pageSize` (`integer`, optional): Items per page. Default: 500. Maximum: 500.
- `propertyIds` (`string`, optional): Filter result by requested properties Comma-separated list.
- `textSearch` (`string`, optional): This will filter all group bookings for the provided free text. Currently it only looks up if either the group name, lastname, firstname, email or company name of the booker contains one of the provided values
- `to` (`string`, optional): The end of the time range. All groups that have blocks overlapping with the interval specified by from and to will be returned A date and time (without fractional second part) in UTC or with UTC offset as defined in ISO8601:2004

Example input: `{}`

### `apaleo_list_invoices`

List Invoices · Read-only

List invoices filtered by property, status or dates.
Returns an object with `invoices`, `count`.
Use to find invoices. Use get_invoice for one invoice.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `bookingIds` (`string`, optional): Filter by booking IDs Comma-separated list.
- `checkedOutOnAccountsReceivable` (`boolean`, optional): If set to `true`, only return invoices with an open balance (AR) Otherwise, returns all.
- `companyIds` (`string`, optional): Filter by company IDs Comma-separated list.
- `dateFilter` (`string`, optional): Filter by invoice date You can provide an array of string expressions which all need to apply. Each expression has the form of 'OPERATION_VALUE' where VALUE needs to be of the valid format of the property type and OPERATION can be: 'eq' for equals 'neq' for not equals 'lt' for less than 'gt' for greater than 'lte' for less than or equals 'gte' for greater than or equals For instance 'eq_5' would mean the value should equal 5 'lte_7' would mean the value should be less than... Comma-separated list.
- `expand` (`string`, optional): List of all embedded resources that should be expanded in the response. Possible values are: allowedActions, company. All other values will be silently ignored. Comma-separated list of: allowedActions, company.
- `folioIds` (`string`, optional): Filter by folio IDs Comma-separated list.
- `nameSearch` (`string`, optional): Find invoices for a recipient name or company. Provide at least three characters.
- `number` (`string`, optional): The invoice number
- `outstandingPaymentFilter` (`string`, optional): Filter for the outstanding balance for invoices You can provide an array of string expressions which all need to apply. Each expression has the form of 'OPERATION_VALUE' where VALUE needs to be of the valid format of the property type and OPERATION can be: 'eq' for equals 'neq' for not equals 'lt' for less than 'gt' for greater than 'lte' for less than or equals 'gte' for greater than or equals For instance 'eq_5' would mean the value should equal 5 'lte_7' would mean the... Comma-separated list.
- `pageNumber` (`integer`, optional): Page number to retrieve. Default: 1. If the page has no items, the API returns 204 No Content.
- `pageSize` (`integer`, optional): Items per page. Default: 500. Maximum: 500.
- `paymentSettled` (`boolean`, optional): If set to `true`, returns only invoices having no outstanding payments or marked as settled. If set to `false`, returns only invoices with outstanding payment and not marked as settled. If not set, returns all invoices. - DEPRECATED: This field will be removed at 25.06.2022. Use filtering by `Status` instead
- `propertyIds` (`string`, optional): Filter by property IDs Comma-separated list.
- `recipientType` (`string`, optional): If nothing is set, invoices addressed both companies and individuals will be returned. If set to `Person`, invoices that addressed to individuals will be returned. If set to `Company`, invoice that addressed to companies will be returned. One of: `Person`, `Company`.
- `reservationIds` (`string`, optional): Filter by reservation IDs Comma-separated list.
- `status` (`string`, optional): Filter by invoice status. One of: `FullyPaid`, `Unpaid`, `WrittenOff`.

Example input: `{}`

### `apaleo_list_languages`

List Languages · Read-only

List the languages enabled for the account.
Returns an object with `languages`.
Use to check supported guest languages.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `apaleo_list_maintenances`

List Maintenances · Read-only

List unit maintenance tasks.
Returns an object with `maintenances`, `count`.
Use to see rooms out of order or service.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `expand` (`string`, optional): List of all embedded resources that should be expanded in the response. Possible values are: unit. All other values will be silently ignored. Comma-separated list of: unit.
- `from` (`string`, optional): Filter all maintenance windows that end after the specified date and time A date and time (without fractional second part) in UTC or with UTC offset as defined in ISO8601:2004
- `pageNumber` (`integer`, optional): Page number to retrieve. Default: 1. If the page has no items, the API returns 204 No Content.
- `pageSize` (`integer`, optional): Items per page. Default: 500. Maximum: 500.
- `propertyId` (`string`, optional): Filter result by property id
- `to` (`string`, optional): Filter all maintenance windows that start before the specified date and time A date and time (without fractional second part) in UTC or with UTC offset as defined in ISO8601:2004
- `types` (`string`, optional): Filter result by maintenance types Comma-separated list of: OutOfService, OutOfOrder, OutOfInventory.
- `unitId` (`string`, optional): Filter result by unit id

Example input: `{}`

### `apaleo_list_market_segments`

List Market Segments · Read-only

List market segments defined for properties.
Returns an object with `marketSegments`, `count`.
Use to find segment ids for rate plans and reservations.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `pageNumber` (`integer`, optional): Page number to retrieve. Default: 1. If the page has no items, the API returns 204 No Content.
- `pageSize` (`integer`, optional): Items per page. Default: 500. Maximum: 500.
- `propertyIds` (`string`, optional): Return market segments with any of the specified property ids Comma-separated list.

Example input: `{}`

### `apaleo_list_no_show_policies`

List No-Show Policies · Read-only

List no-show policies defined for properties.
Returns an object with `noShowPolicies`, `count`.
Use to find policy ids for rate plans.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `pageNumber` (`integer`, optional): Page number to retrieve. Default: 1. If the page has no items, the API returns 204 No Content.
- `pageSize` (`integer`, optional): Items per page. Default: 500. Maximum: 500.
- `propertyId` (`string`, optional): Filter no-show policies by the specified property

Example input: `{}`

### `apaleo_list_offers`

List Offers · Read-only

List bookable offers with prices for a property, dates and guest count.
Returns an object with `property`, `offers`.
Use before create_booking to get available rates and unit groups.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `adults` (`integer`, required): The number of adults you want offers for
- `arrival` (`string`, required): Date and optional time of arrival Specify either a pure date or a date and time (without fractional second part) in UTC or with UTC offset as defined in ISO8601:2004
- `departure` (`string`, required): Date and optional time of departure. Cannot be more than 5 years after arrival. Specify either a pure date or a date and time (without fractional second part) in UTC or with UTC offset as defined in ISO8601:2004
- `propertyId` (`string`, required): The property ID
- `channelCode` (`string`, optional): Channel code, used to filter the rate plans. One of: `Direct`, `BookingCom`, `Ibe`, `ChannelManager`, `Expedia`, `Homelike`, `Hrs`, `AltoVita`, `DesVu`, `Gimsi`.
- `childrenAges` (`string`, optional): The ages of the children you want offers for Comma-separated list.
- `corporateCode` (`string`, optional): The code associated with a corporate rate
- `includeUnavailable` (`boolean`, optional): Return also offers that are currently not publicly bookable as restrictions are violated. By default only available offers are returned
- `promoCode` (`string`, optional): The promo code associated with a certain special offer
- `timeSliceDefinitionIds` (`string`, optional): Time slice definition IDs, used to filter rate plans Comma-separated list.
- `timeSliceTemplate` (`string`, optional): The time slice template used to filter the rate plans, defaults to 'over night'. One of: `DayUse`, `OverNight`.
- `unitGroupIds` (`string`, optional): Unit group IDs, used to filter rate plans Comma-separated list.
- `unitGroupTypes` (`string`, optional): Unit group types, used to filter rate plans Comma-separated list of: BedRoom, MeetingRoom, EventSpace, ParkingLot, Other.

Example input: `{"adults":1,"arrival":"<arrival>","departure":"<departure>","propertyId":"<propertyId>"}`

### `apaleo_list_payment_methods`

List Payment Methods · Read-only

List the payment method values supported by Apaleo.
Returns an object with `paymentMethods`.
Use to pick a valid method for create_folio_payment.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `apaleo_list_promo_codes`

List Promo Codes · Read-only

List the promo codes of a rate plan.
Returns an object with `promoCodes`, `count`.
Use to look up codes guests can use at booking.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `pageNumber` (`integer`, optional): Page number to retrieve. Default: 1. If the page has no items, the API returns 204 No Content.
- `pageSize` (`integer`, optional): Items per page. Default: 500. Maximum: 500.
- `propertyId` (`string`, optional): Return codes for a specific property

Example input: `{}`

### `apaleo_list_properties`

List Properties · Read-only

List the hotel properties in the account, optionally filtered by status or country.
Returns an object with `properties`, `count`.
Use to find property ids needed by most other tools. Use get_property for one property.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `countryCode` (`string`, optional): Filter result by country code Comma-separated list.
- `expand` (`string`, optional): List of all embedded resources that should be expanded in the response. Possible values are: actions. All other values will be silently ignored. Comma-separated list of: actions.
- `includeArchived` (`boolean`, optional): Include archived properties in the result. If not set, or set to false, it only returns non-archived properties
- `pageNumber` (`integer`, optional): Page number to retrieve. Default: 1. If the page has no items, the API returns 204 No Content.
- `pageSize` (`integer`, optional): Items per page. Default: 500. Maximum: 500.
- `status` (`string`, optional): Filter result by property status Comma-separated list of: Test, Live.

Example input: `{}`

### `apaleo_list_rate_plans`

List Rate Plans · Read-only

List rate plans, optionally filtered by property, unit group or channel.
Returns an object with `ratePlans`, `count`.
Use to find rate plan ids for offers and bookings.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `baseRatePlanIds` (`string`, optional): Return rate plans derived from any of the specified rate plans Comma-separated list.
- `cancellationPolicyIds` (`string`, optional): Return rate plans with any of the specified cancellation policies Comma-separated list.
- `channelCodes` (`string`, optional): Return rate plans that are sold though any of the specified channels Comma-separated list of: Direct, BookingCom, Ibe, ChannelManager, Expedia, Homelike, Hrs, AltoVita, DesVu, Gimsi.
- `companyIds` (`string`, optional): Return rate plans filtered by requested companies Comma-separated list.
- `derivationLevelFilter` (`string`, optional): This will filter rate plans based on their derivation level. You can provide an array of string expressions which all need to apply. Each expression has the form of 'OPERATION_VALUE' where VALUE needs to be of the valid format of the property type and OPERATION can be: 'eq' for equals 'neq' for not equals 'lt' for less than 'gt' for greater than 'lte' for less than or equals 'gte' for greater than or equals For instance 'eq_5' would mean the value should equal 5 'lte_7'... Comma-separated list.
- `expand` (`string`, optional): List of all embedded resources that should be expanded in the response. Possible values are: property, unitGroup, cancellationPolicy, services, bookingPeriods, surcharges, ageCategories. All other values will be silently ignored. Comma-separated list of: property, unitGroup, cancellationPolicy, services, bookingPeriods, surcharges, ageCategories.
- `includeArchived` (`boolean`, optional): Return archived rate plans. Defaults to false
- `includedServiceIds` (`string`, optional): Return rate plans that have any of the requested included services Comma-separated list.
- `isDerived` (`boolean`, optional): Return only derived or base rate plans
- `minGuaranteeTypes` (`string`, optional): Return rate plans with any of the specified min guarantee types Comma-separated list of: PM6Hold, CreditCard, Prepayment, Company.
- `noShowPolicyIds` (`string`, optional): Return rate plans with any of the specified no-show policies Comma-separated list.
- `pageNumber` (`integer`, optional): Page number to retrieve. Default: 1. If the page has no items, the API returns 204 No Content.
- `pageSize` (`integer`, optional): Items per page. Default: 500. Maximum: 500.
- `promoCodes` (`string`, optional): Return rate plans that have any of the requested promo codes Comma-separated list.
- `propertyId` (`string`, optional): Return rate plans for the specific property
- `ratePlanCodes` (`string`, optional): Return rate plans filtered by requested codes Comma-separated list.
- `timeSliceDefinitionIds` (`string`, optional): Return rate plans with any of the specified time slice definitions Comma-separated list.
- `timeSliceTemplate` (`string`, optional): The time slice template, defaults to 'over night'. One of: `DayUse`, `OverNight`.
- `unitGroupIds` (`string`, optional): Return rate plans with any of the specified unit groups Comma-separated list.
- `unitGroupTypes` (`string`, optional): Return rate plans with any of the specified unit group types Comma-separated list of: BedRoom, MeetingRoom, EventSpace, ParkingLot, Other.

Example input: `{}`

### `apaleo_list_rates`

List Rates · Read-only

List the daily rates of a rate plan over a time range.
Returns an object with `rates`, `count`.
Use to read prices. Use update_rates to change them.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `from` (`string`, required): The start of the time range to filter the rates by. All rates where the from date and time is equal or later than the specified date and optional time will be affected Specify either a pure date or a date and time (without fractional second part) in UTC or with UTC offset as defined in ISO8601:2004
- `ratePlanId` (`string`, required): The id of the rate plan.
- `to` (`string`, required): The end of the time range to filter the rates by. All rates where the from date and time is earlier than the specified date and optional time will be affected Specify either a pure date or a date and time (without fractional second part) in UTC or with UTC offset as defined in ISO8601:2004
- `pageNumber` (`integer`, optional): Page number to retrieve. Default: 1. If the page has no items, the API returns 204 No Content.
- `pageSize` (`integer`, optional): Items per page. Default: 500. Maximum: 500.

Example input: `{"from":"<from>","ratePlanId":"<ratePlanId>","to":"<to>"}`

### `apaleo_list_reservation_available_units`

List Units Available For Reservation · Read-only

List the units that can be assigned to a specific reservation.
Returns an object with `units`, `count`.
Use before assign_unit to choose a valid unit.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `reservationId` (`string`, required): The id of the reservation
- `from` (`string`, optional): The from date and time A date and time (without fractional second part) in UTC or with UTC offset as defined in ISO8601:2004
- `includeOutOfService` (`boolean`, optional): Should units that are set OutOfService in the defined time period be returned as available.
- `pageNumber` (`integer`, optional): Page number to retrieve. Default: 1. If the page has no items, the API returns 204 No Content.
- `pageSize` (`integer`, optional): Items per page. Default: 500. Maximum: 500.
- `to` (`string`, optional): The to date and time A date and time (without fractional second part) in UTC or with UTC offset as defined in ISO8601:2004
- `unitAttributeIds` (`string`, optional): Return units with the specific unit attributes Comma-separated list.
- `unitCondition` (`string`, optional): The unit condition. One of: `Clean`, `CleanToBeInspected`, `Dirty`.
- `unitGroupId` (`string`, optional): The unit group id

Example input: `{"reservationId":"<reservationId>"}`

### `apaleo_list_reservation_services`

List Reservation Services · Read-only

List the services booked on a reservation.
Returns an object with `services`, `count`.
Use to see extras such as breakfast on a stay.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `reservationId` (`string`, required): Id of the reservation.

Example input: `{"reservationId":"<reservationId>"}`

### `apaleo_list_reservations`

List Reservations · Read-only

List reservations filtered by property, status, dates, guest or unit.
Returns an object with `reservations`, `count`.
Use to browse stays. Use get_reservation for one stay.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `allFoliosHaveInvoice` (`boolean`, optional): If set to `true`, returns only reservations, in which all folios are closed and have an invoice. If set to `false`, returns only reservations, in which some of the folios are open or don't have an invoice
- `balanceFilter` (`string`, optional): This will filter reservations based on their balance. You can provide an array of string expressions which all need to apply. Each expression has the form of 'OPERATION_VALUE' where VALUE needs to be of the valid format of the property type and OPERATION can be: 'eq' for equals 'neq' for not equals 'lt' for less than 'gt' for greater than 'lte' for less than or equals 'gte' for greater than or equals For instance 'eq_5' would mean the value should equal 5 'lte_7' would mean... Comma-separated list.
- `blockIds` (`string`, optional): Filter result by requested blocks Comma-separated list.
- `bookingId` (`string`, optional): Filter result by booking id
- `channelCode` (`string`, optional): Filter result by the channel code Comma-separated list of: Direct, BookingCom, Ibe, ChannelManager, Expedia, Homelike, Hrs, AltoVita, DesVu, Gimsi.
- `companyIds` (`string`, optional): Filter result by requested companies Comma-separated list.
- `dateFilter` (`string`, optional): Filter by date and time attributes of reservation. Use in combination with the 'To' and 'From' attributes. All filters will check if the date specified by the filter type is between from (included) and to (excluded). The exception being filtering for 'stay', which will return all reservations that are overlapping with the interval specified by from and to. One of: `Arrival`, `Departure`, `Stay`, `Creation`, `Modification`, `Cancellation`, `ArrivalAndCheckIn`, `DepartureAndCheckOut`.
- `expand` (`string`, optional): List of all embedded resources that should be expanded in the response. Possible values are: booker, actions, timeSlices, services, assignedUnits, company. All other values will be silently ignored. Comma-separated list of: booker, actions, timeSlices, services, assignedUnits, company.
- `externalCode` (`string`, optional): Filter result by the external code. The result set will contain all reservations that have an external code starting with the provided value
- `externalReferences` (`string`, optional): This will filter all reservation where the provided external references have an exact match on at least one of the properties in Apaleo.Api.Modules.Booking.Models.Reservation.ExternalReferencesModel Comma-separated list.
- `from` (`string`, optional): The start of the time interval. When filtering by date, at least one of 'from' and 'to' has to be specified A date and time (without fractional second part) in UTC or with UTC offset as defined in ISO8601:2004
- `hasActivePaymentAccount` (`boolean`, optional): If set to `true`, returns only the reservations with an active payment account. If set to `false`, returns only the reservations without an active payment account.
- `isPreCheckedIn` (`boolean`, optional): If set to `true`, returns only the reservations marked as pre-checked-in. If set to `false`, returns only the reservations not marked as pre-checked-in.
- `marketSegmentIds` (`string`, optional): Filter result by requested market segments Comma-separated list.
- `pageNumber` (`integer`, optional): Page number to retrieve. Default: 1. If the page has no items, the API returns 204 No Content.
- `pageSize` (`integer`, optional): Items per page. Default: 500. Maximum: 500.
- `propertyIds` (`string`, optional): Filter result by requested properties Comma-separated list.
- `ratePlanIds` (`string`, optional): Filter result by requested rate plans Comma-separated list.
- `sort` (`string`, optional): List of all fields that can be used to sort the results. Possible values are: arrival:asc, arrival:desc, departure:asc, departure:desc, created:asc, created:desc, updated:asc, updated:desc, balance:asc, balance:desc, id:asc, id:desc, firstname:asc, firstname:desc, lastname:asc, lastname:desc, unitname:asc, unitname:desc. All other values will be silently ignored. Comma-separated list of: arrival:asc, arrival:desc, departure:asc, departure:desc, created:asc, created:desc, updated:asc, updated:desc, balance:asc, balance:desc, id:asc, id:desc, firstname:asc, firstname:desc, lastname:asc, lastname:desc, unitname:asc, unitname:desc.
- `sources` (`string`, optional): Filter result by source Comma-separated list.
- `status` (`string`, optional): Filter result by reservation status Comma-separated list of: Confirmed, InHouse, CheckedOut, Canceled, NoShow.
- `textSearch` (`string`, optional): Filters reservations by searching for the provided text across multiple fields. The search is case-insensitive and includes: - Booker information (first name, last name, email, company name) - Primary guest information (first name, last name, email, company name) - Additional guest information (first name, last name, email, company name) - Reservation details (external code, external references, reservation ID) - Unit name - Group name
- `to` (`string`, optional): The end of the time interval, must be larger than 'from'. When filtering by date, at least one of 'from' and 'to' has to be specified A date and time (without fractional second part) in UTC or with UTC offset as defined in ISO8601:2004
- `unitGroupIds` (`string`, optional): Filter result by requested unit groups Comma-separated list.
- `unitGroupTypes` (`string`, optional): Filter result by requested unit group types Comma-separated list of: BedRoom, MeetingRoom, EventSpace, ParkingLot, Other.
- `unitIds` (`string`, optional): Filter result by assigned units Comma-separated list.
- `validationMessageCategory` (`string`, optional): Filter result by validation message category Comma-separated list of: OfferNotAvailable, AutoUnitAssignment, GuestLoyalty.

Example input: `{}`

### `apaleo_list_service_offers`

List Service Offers · Read-only

List bookable service offers with prices for a stay.
Returns an object with `services`.
Use to price extras before booking them.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `adults` (`integer`, required): The number of adults you want offers for
- `arrival` (`string`, required): Date and optional time of arrival Specify either a pure date or a date and time (without fractional second part) in UTC or with UTC offset as defined in ISO8601:2004
- `departure` (`string`, required): Date and optional time of departure. Cannot be more than 5 years after arrival. Specify either a pure date or a date and time (without fractional second part) in UTC or with UTC offset as defined in ISO8601:2004
- `ratePlanId` (`string`, required): The rate plan ID
- `channelCode` (`string`, optional): The channel code used to filter the services. One of: `Direct`, `BookingCom`, `Ibe`, `ChannelManager`, `Expedia`, `Homelike`, `Hrs`, `AltoVita`, `DesVu`, `Gimsi`.
- `childrenAges` (`string`, optional): The ages of the children you want offers for Comma-separated list.
- `includeUnavailable` (`boolean`, optional): Return also offers that are currently not publicly bookable as restrictions are violated. By default only available offers are returned
- `onlyDefaultDates` (`boolean`, optional): Depending on the postNextDay setting of a service it will be posted before or after midnight. Breakfast is usually delivered on the next morning, having 'postNextDay' set to true. Its 'default dates' are from the day after arrival until the departure day. For services like dinner 'postNextDay' is false, and default dates are day of arrival until one day before departure. With this query parameter set to 'false', you can also ask for dates outside of those default dates. It...

Example input: `{"adults":1,"arrival":"<arrival>","departure":"<departure>","ratePlanId":"<ratePlanId>"}`

### `apaleo_list_services`

List Services · Read-only

List bookable services such as breakfast or parking.
Returns an object with `services`, `count`.
Use to find service ids to book with book_service.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `channelCodes` (`string`, optional): The channel codes the service is sold through Comma-separated list of: Direct, BookingCom, Ibe, ChannelManager, Expedia, Homelike, Hrs, AltoVita, DesVu, Gimsi.
- `expand` (`string`, optional): List of all embedded resources that should be expanded in the response. Possible values are: property. All other values will be silently ignored. Comma-separated list of: property.
- `onlySoldAsExtras` (`boolean`, optional): If set to true, return only services that can be sold as extras. Otherwise, it returns both, extras, and include-only.
- `pageNumber` (`integer`, optional): Page number to retrieve. Default: 1. If the page has no items, the API returns 204 No Content.
- `pageSize` (`integer`, optional): Items per page. Default: 500. Maximum: 500.
- `propertyId` (`string`, optional): Filter services by the specified property
- `serviceTypes` (`string`, optional): The service types offered Comma-separated list of: Other, Accommodation, FoodAndBeverages.
- `textSearch` (`string`, optional): This will filter all services for the provided free text. Currently it only looks up if the service name contains one of the provided values.

Example input: `{}`

### `apaleo_list_sub_accounts`

List Sub-Accounts · Read-only

List sub-accounts used to categorize charges.
Returns an object with `subAccounts`, `count`.
Use to find sub-account ids for charges.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `propertyId` (`string`, required): ID of the property
- `pageNumber` (`integer`, optional): Page number to retrieve. Default: 1. If the page has no items, the API returns 204 No Content.
- `pageSize` (`integer`, optional): Items per page. Default: 500. Maximum: 500.

Example input: `{"propertyId":"<propertyId>"}`

### `apaleo_list_unit_attributes`

List Unit Attributes · Read-only

List unit attributes such as view or amenities that can be assigned to units.
Returns an object with `unitAttributes`, `count`.
Use to find attribute ids before creating or updating units.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `pageNumber` (`integer`, optional): Page number to retrieve. Default: 1. If the page has no items, the API returns 204 No Content.
- `pageSize` (`integer`, optional): Items per page. Default: 500. Maximum: 500.

Example input: `{}`

### `apaleo_list_unit_groups`

List Unit Groups · Read-only

List unit groups (room types) in the account, optionally filtered by property or type.
Returns an object with `unitGroups`, `count`.
Use to find unit group ids for offers, reservations and rates.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `expand` (`string`, optional): List of all embedded resources that should be expanded in the response. Possible values are: property, connectedUnitGroups. All other values will be silently ignored. Comma-separated list of: property, connectedUnitGroups.
- `pageNumber` (`integer`, optional): Page number to retrieve. Default: 1. If the page has no items, the API returns 204 No Content.
- `pageSize` (`integer`, optional): Items per page. Default: 500. Maximum: 500.
- `propertyId` (`string`, optional): Return unit groups for specific property
- `unitGroupTypes` (`string`, optional): unitGroupTypes Comma-separated list of: BedRoom, MeetingRoom, EventSpace, ParkingLot, Other.

Example input: `{}`

### `apaleo_list_units`

List Units · Read-only

List physical units (rooms, spaces) in the account, optionally filtered by property, unit group or condition.
Returns an object with `units`, `count`.
Use to browse inventory. Use list_available_units for what is free to book.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `condition` (`string`, optional): Return units with a specific condition. One of: `Clean`, `CleanToBeInspected`, `Dirty`.
- `expand` (`string`, optional): List of all embedded resources that should be expanded in the response. Possible values are: property, unitGroup, connectedUnits, actions. All other values will be silently ignored. Comma-separated list of: property, unitGroup, connectedUnits, actions.
- `isOccupied` (`boolean`, optional): Return only occupied or vacant units
- `maintenanceType` (`string`, optional): Return units with the specific maintenance type. One of: `OutOfService`, `OutOfOrder`, `OutOfInventory`.
- `pageNumber` (`integer`, optional): Page number to retrieve. Default: 1. If the page has no items, the API returns 204 No Content.
- `pageSize` (`integer`, optional): Items per page. Default: 500. Maximum: 500.
- `propertyId` (`string`, optional): Return units for specific property
- `status` (`string`, optional): Return active units, archived units, or all units. Defaults to active. One of: `Active`, `Archived`, `All`.
- `textSearch` (`string`, optional): This will filter all units where the provided text is contained in the unit name. The search is case insensitive.
- `unitAttributeIds` (`string`, optional): Return units with the specific unit attributes Comma-separated list.
- `unitGroupId` (`string`, optional): Return units for the specific unit group - DEPRECATED: This property will be removed 20.04.2022. Use `UnitGroupIds` instead
- `unitGroupIds` (`string`, optional): Return units with the specific unit groups Comma-separated list.

Example input: `{}`

### `apaleo_add_reservations_to_booking`

Add Reservations To Booking · Write

Add one or more reservations to an existing booking.
Returns an object with `reservationIds`.
Use to extend a booking with extra rooms.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `bookingId` (`string`, required): Id of the booking the reservations should be attached to.
- `reservations` (`array`, required): List of reservations to add to the existing booking. Each item needs: adults, arrival, channelCode, departure, timeSlices. Example: [{"arrival":"2026-11-01","departure":"2026-11-01","adults":2,"channelCode":"Direct","timeSlices":[{"ratePlanId":"MUC-FLEX-DBL"}]}]
- `transactionReference` (`string`, optional): The reference of a payment transaction. This should be set when a payment transaction has been initiated and should be used to complete the transaction upon reservation creation. When set, the payment transaction completion is always triggered regardless of the reservation guarantee type and payment automation settings.

Example input: `{"bookingId":"<bookingId>","reservations":[]}`

### `apaleo_amend_reservation`

Amend Reservation · Write

Change the stay of a reservation such as dates, guests, unit group or rate plan.
Returns no response body on success (HTTP 204).
Use to modify the stay itself. Use update_reservation for non-stay fields.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `adults` (`integer`, required): Number of adults.
- `arrival` (`string`, required): Date and optional time of arrival Specify either a pure date or a date and time (without fractional second part) in UTC or with UTC offset as defined in ISO8601:2004.
- `departure` (`string`, required): Date and optional time of departure. Cannot be more than 5 years after arrival. Specify either a pure date or a date and time (without fractional second part) in UTC or with UTC offset as defined in ISO8601:2004.
- `reservationId` (`string`, required): Id of the reservation that should be modified
- `timeSlices` (`array`, required): The list of time slices. Each item needs: ratePlanId. Example: [{"ratePlanId":"MUC-FLEX-DBL"}]
- `childrenAges` (`array`, optional): Ages of the children.
- `requote` (`boolean`, optional): Whether the prices for time slices with no change to the rate plan should be re-quoted based on current prices, or if only additions like change of number of adults should be calculated. If a reservation is part of a block, the time slices prices will always be re-quoted to the current price of the block. Defaults to 'false'.

Example input: `{"adults":1,"arrival":"<arrival>","departure":"<departure>","reservationId":"<reservationId>","timeSlices":[{"ratePlanId":"MUC-FLEX-DBL"}]}`

### `apaleo_assign_specific_unit`

Assign Specific Unit · Write

Assign a chosen unit to a reservation.
Returns an object with `unit`.
Use when the unit is already decided. Check options with list_reservation_available_units.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `reservationId` (`string`, required): Id of the reservation the unit should be assigned to.
- `unitId` (`string`, required): The id of the unit to be assigned.
- `from` (`string`, optional): The start date and optional time for the unit assignment. If not specified, the reservation's arrival will be used. Specify either a pure date or a date and time (without fractional second part) in UTC or with UTC offset as defined in ISO8601:2004
- `lockUnit` (`boolean`, optional): Whether to lock the unit for the duration of the reservation. If not specified, the unit will not be locked.
- `to` (`string`, optional): The end date and optional time for the unit assignment. If not specified, the reservation's departure will be used. Specify either a pure date or a date and time (without fractional second part) in UTC or with UTC offset as defined in ISO8601:2004

Example input: `{"reservationId":"<reservationId>","unitId":"<unitId>"}`

### `apaleo_assign_unit`

Assign Unit · Write

Automatically assign an available unit to a reservation.
Returns an object with `timeSlices`.
Use for automatic room assignment. Use assign_specific_unit to pick the unit.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `reservationId` (`string`, required): Id of the reservation a unit should be assigned to.
- `unitConditions` (`string`, optional): The optional unit conditions for unit that you want to auto assign for. Comma-separated list of: Clean, CleanToBeInspected, Dirty.

Example input: `{"reservationId":"<reservationId>"}`

### `apaleo_book_service`

Book Service · Write

Add a service to a reservation.
Returns no response body on success (HTTP 204).
Use to add an extra. Find service ids with list_services.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `reservationId` (`string`, required): Id of the reservation.
- `serviceId` (`string`, required): The id of the service you want to book.
- `amount` (`object`, optional): The amount of the request. Required fields: amount, currency. Example: {"amount":99.5,"currency":"example"}
- `count` (`integer`, optional): The number of services to book for each service date. It defaults to the service offer count when not specified.
- `dates` (`array`, optional): The optional dates you want to book the service for; if not specified the default service pattern will be used (e.g. whole stay). Each item needs: serviceDate. Example: [{"serviceDate":"2026-11-01"}]

Example input: `{"reservationId":"<reservationId>","serviceId":"<serviceId>"}`

### `apaleo_cancel_reservation`

Cancel Reservation · Write

Cancel a confirmed reservation whose arrival is in the future.
Returns no response body on success (HTTP 204).
Use to cancel a stay. Use mark_no_show for guests who did not arrive.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `reservationId` (`string`, required): Id of the reservation that should be processed.

Example input: `{"reservationId":"<reservationId>"}`

### `apaleo_check_in_reservation`

Check In Reservation · Write

Check in a confirmed reservation that has a unit assigned.
Returns no response body on success (HTTP 204).
Use at arrival. Assign a unit first.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `reservationId` (`string`, required): Id of the reservation that should be processed.
- `withCityTax` (`boolean`, optional): Define if city tax should be added for this reservation or not. The default is "true".

Example input: `{"reservationId":"<reservationId>"}`

### `apaleo_check_out_reservation`

Check Out Reservation · Write

Check out an in-house reservation.
Returns no response body on success (HTTP 204).
Use at departure after the folio is settled.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `reservationId` (`string`, required): Id of the reservation that should be processed.

Example input: `{"reservationId":"<reservationId>"}`

### `apaleo_close_folio`

Close Folio · Write

Close a folio so no further changes are possible.
Returns no response body on success (HTTP 204).
Use once the bill is settled.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `folioId` (`string`, required): The folio ID.

Example input: `{"folioId":"<folioId>"}`

### `apaleo_create_booking`

Create Booking · Write

Create a booking with a booker and one or more reservations.
Returns an object with `id`, `reservationIds`.
Use to make a new reservation from a chosen offer. Fetch offers first with list_offers.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `booker` (`object`, required): The booker of the request. Required fields: lastName. Example: {"lastName":"Schmidt"}
- `reservations` (`array`, required): List of reservations to create. Each item needs: adults, arrival, channelCode, departure, timeSlices. Example: [{"arrival":"2026-11-01","departure":"2026-11-01","adults":2,"channelCode":"Direct","timeSlices":[{"ratePlanId":"MUC-FLEX-DBL"}]}]
- `bookerComment` (`string`, optional): Additional information and comments by the booker.
- `comment` (`string`, optional): Additional information and comments.
- `paymentAccount` (`object`, optional): The payment account of the request. Example: {"accountNumber":"example","accountHolder":"example"}
- `registeredCard` (`object`, optional): Use registered card when you need to show details about a card you intend to add to the booking/reservation in the future as a real payment account. It is NOT a replacement of the deprecated PaymentAccount field. Example: {"cardNumber":"example","cardHolder":"example"}
- `transactionReference` (`string`, optional): The reference of a payment transaction. This should be set when a payment transaction has been initiated and should be used to complete the transaction upon reservation creation. When set, the payment transaction completion is always triggered regardless of the reservation guarantee type and payment automation settings.

Example input: `{"booker":{"lastName":"Schmidt"},"reservations":[]}`

### `apaleo_create_company`

Create Company · Write

Create a company profile for a property.
Returns an object with `id`.
Use to register a corporate customer before attaching reservations.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `address` (`object`, required): The address of the request. Required fields: addressLine1, city, countryCode, postalCode. Example: {"addressLine1":"example","postalCode":"example","city":"example","countryCode":"DE"}
- `canCheckOutOnAr` (`boolean`, required): Whether or not the company is allowed to check out on AR / invoice.
- `code` (`string`, required): The code for the company.
- `name` (`string`, required): The name of the company.
- `propertyId` (`string`, required): The ID of the property.
- `additionalTaxId` (`string`, optional): The additional tax ID of the company (e.g. SIRET in France, Codice Destinatario in Italy, SST in Malaysia).
- `additionalTaxId2` (`string`, optional): The additional tax ID of the company (e.g. Codice Fiscale in Italy, BRN in Malaysia).
- `invoiceNetworkIdentity` (`object`, optional): The invoice network identity of the request. Required fields: id, network. Example: {"network":"Peppol","id":"MUC-ABC123-1"}
- `invoicingEmail` (`string`, optional): The email address for invoicing purposes.
- `phone` (`string`, optional): The company's phone.
- `ratePlans` (`array`, optional): Rate plans that can be booked by this company. Each item needs: id. Example: [{"id":"MUC-ABC123-1"}]
- `taxId` (`string`, optional): The tax ID of the company.

Example input: `{"address":{"addressLine1":"example","postalCode":"example","city":"example","countryCode":"DE"},"canCheckOutOnAr":true,"code":"<code>","name":"<name>","propertyId":"<propertyId>"}`

### `apaleo_create_folio`

Create Folio · Write

Create an additional folio for a reservation or company.
Returns an object with `id`.
Use to split charges across bills.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `debitor` (`object`, required): The debitor of the request. Example: {"type":"Booker","title":"Mr"}
- `code` (`string`, optional): Optional code for external folios. If present, the id of the folio will be propertyId-code (MUC-SOMETHING); If no code is provided, the id of the folio will be propertyId-ext-number (MUC-EXT-282).
- `companyId` (`string`, optional): The ID of the company for which a folio should be created.
- `propertyId` (`string`, optional): The ID of the property for which an external folio should be created.
- `reservationId` (`string`, optional): The ID of the reservation for which a guest folio should be created.
- `type` (`string`, optional): The type of the folio to create. Default is the guest folio. This field will become required 01.11.2019. One of: `Guest`, `External`.

Example input: `{"debitor":{"type":"Booker","title":"Mr"}}`

### `apaleo_create_folio_payment`

Create Folio Payment · Write

Post a payment to a folio.
Returns an object with `id`.
Use to record a payment received outside Apaleo Pay.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `amount` (`object`, required): The amount of the request. Required fields: amount, currency. Example: {"amount":99.5,"currency":"example"}
- `folioId` (`string`, required): Id of the folio.
- `method` (`string`, required): The payment method. Use 'CreditCard', if none of the specific credit cards types matches. 'Booking.com' only makes sense, if the property (hotel) configured Booking.com > Finance to be 'Payments by Booking.com'. One of: `Cash`, `BankTransfer`, `CreditCard`, `Amex`, `VisaCredit`, `VisaDebit`, `MasterCard`, `MasterCardDebit`, `Maestro`, `GiroCard`, `DiscoverCard`, `Diners`, `Jcb`, `BookingCom`, `VPay`, `PayPal`, `Postcard`, `Reka`, `Twint`, `Lunchcheck`, `Voucher`, `ChinaUnionPay`, `Other`, `Cheque`, `Airbnb`, `HolidayCheck`, `Representation`, `IDeal`.
- `businessDate` (`string`, optional): The business date of the payment. Defaults to the current date. In some cases you might want to post the payments to the previous business date, this is only possible until 6 AM of the current day.
- `paidCharges` (`array`, optional): List of charges and amount being covered by this payment. Each item needs: amount, chargeId. Example: [{"chargeId":"MUC-ABC123-1","amount":99.5}]
- `receipt` (`string`, optional): The optional receipt you want to store for the payment. It defaults to the reservation or external folio id. This field is required if you are adding payment to the house account.

Example input: `{"amount":{"amount":99.5,"currency":"example"},"folioId":"<folioId>","method":"Cash"}`

### `apaleo_create_invoice`

Create Invoice · Write

Create an invoice from a closed folio.
Returns an object with `id`.
Use after close_folio.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `folioId` (`string`, required): The ID of the folio for which the invoice should be created.
- `languageCode` (`string`, required): The language in which the invoice should be produced.

Example input: `{"folioId":"<folioId>","languageCode":"<languageCode>"}`

### `apaleo_create_maintenance`

Create Maintenance · Write

Create a maintenance task for a unit.
Returns an object with `id`.
Use to take a room out of service for a period.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `from` (`string`, required): Date and time the maintenance begins. Has to be today or on a day in the future A date and time (without fractional second part) in UTC or with UTC offset as defined in ISO8601:2004.
- `to` (`string`, required): Date and time the maintenance ends. Has to be later than from A date and time (without fractional second part) in UTC or with UTC offset as defined in ISO8601:2004.
- `type` (`string`, required): The type of maintenance that is planned for the unit. A small repair (OutOfService), a bigger disfunction that does not allow to sell the unit (OutOfOrder) or is it under construction (OutOfInventory). One of: `OutOfService`, `OutOfOrder`, `OutOfInventory`.
- `unitId` (`string`, required): The id of the unit.
- `description` (`string`, optional): Description of the maintenance.

Example input: `{"from":"<from>","to":"<to>","type":"OutOfService","unitId":"<unitId>"}`

### `apaleo_create_rate_plan`

Create Rate Plan · Write

Create a rate plan in a property.
Returns an object with `id`.
Use to add a new price plan with its policies and unit groups.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `cancellationPolicyId` (`string`, required): The id of the cancellation policy valid for this rate plan.
- `channelCodes` (`array`, required): The channel codes the rate plan is sold through.
- `code` (`string`, required): The code for the rate plan that can be shown in reports and table views.
- `description` (`object`, required): The description for the rate plan. Provide a map of two-letter language code to text. Example: {"en":"Spacious double room"}
- `minGuaranteeType` (`string`, required): The minimum guarantee to be provided when this rate plan is booked so the reservation will be guaranteed to the guest. One of: `PM6Hold`, `CreditCard`, `Prepayment`, `Company`.
- `name` (`object`, required): The name for the rate plan. Provide a map of two-letter language code to text. Example: {"en":"Deluxe Double"}
- `propertyId` (`string`, required): The id of the property for which the rate plan will be created.
- `timeSliceDefinitionId` (`string`, required): Defines the time periods for which the unit group related to this rate plan is rented out.
- `unitGroupId` (`string`, required): The id of the unit group offered with this rate plan.
- `accountingConfigs` (`array`, optional): The collection of accounting configs with validity periods. This is a temporary field, avoid using it. Each item needs: serviceType, validFrom, vatType. Example: [{"vatType":"Null","serviceType":"Other","validFrom":"2026-11-01"}]
- `ageCategories` (`array`, optional): Additional charges per age category. Each item needs: id, surcharges. Example: [{"id":"MUC-ABC123-1","surcharges":[{"adults":2,"value":99.5}]}]
- `bookingPeriods` (`array`, optional): Time periods when the rate plan is bookable. Each item needs: from, to. Example: [{"from":"2026-11-01T00:00:00Z","to":"2026-11-01T00:00:00Z"}]
- `companies` (`array`, optional): Companies that can use this rate plan. Each item needs: id. Example: [{"id":"MUC-ABC123-1"}]
- `includedServices` (`array`, optional): Services that are included in the rate plan. Each item needs: grossPrice, serviceId. Example: [{"serviceId":"BRK","grossPrice":{"amount":99.5,"currency":"example"}}]
- `isSubjectToCityTax` (`boolean`, optional): Whether the rate plan is subject to city tax or not. Default value is `true`.
- `marketSegmentId` (`string`, optional): The id of the market segment for this rate plan.
- `noShowPolicyId` (`string`, optional): The id of the no-show policy valid for this rate plan.
- `priceCalculationMode` (`string`, optional): The calculation mode is used when calculating the adults' surcharges and derived rates. Defaults to Truncate. Example: for a rate of 125.99 and a surcharge of +10%, when Truncate is selected, the result would be 125.99 + 12 = 137.99 When Round is selected, the result would be 125.99 + 12.60 = 138.59. One of: `Truncate`, `Round`.
- `pricingRule` (`object`, optional): The pricing rule of the request. Required fields: baseRatePlanId, type, value. Example: {"baseRatePlanId":"MUC-ABC123-1","type":"Absolute","value":99.5}
- `promoCodes` (`array`, optional): The rate codes for promotional and hidden rates. If at least one code is set the rate will be not publicly visible anymore and only be offered when one of the promo codes is given in the offer request. For backward compatibility it is still not possible to set multiple promo codes.
- `restrictions` (`object`, optional): The restrictions of the request.
- `surcharges` (`array`, optional): Additional charges for more than single occupancy. The percent or absolute value will be added to the manually defined or calculated derived rates. The values for 'adults' must be unique within the list and starting from occupancy of 2 adults. Values higher than the maximum unit group occupancy will be silently ignored. The surcharges are required for all possible occupancies defined by the 'MaxPersons' of the unit group. Each item needs: adults, type, value. Example: [{"adults":2,"type":"Absolute","value":99.5}]

Example input: `{"cancellationPolicyId":"<cancellationPolicyId>","channelCodes":[],"code":"<code>","description":{"en":"Spacious double room"},"minGuaranteeType":"PM6Hold","name":{"en":"Deluxe Double"},"propertyId":"<propertyId>","timeSliceDefinitionId":"<timeSliceDefinitionId>","unitGroupId":"<unitGroupId>"}`

### `apaleo_create_unit`

Create Unit · Write

Create a single unit in a property and unit group.
Returns an object with `id`.
Use for one unit. Use create_units_bulk for many.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `description` (`object`, required): The description for the unit. Provide a map of two-letter language code to text. Example: {"en":"Spacious double room"}
- `maxPersons` (`integer`, required): Maximum number of persons for the unit.
- `name` (`string`, required): The name for the unit.
- `propertyId` (`string`, required): The id of the property where the unit will be created.
- `attributes` (`array`, optional): Collection of user defined attributes of unit. Each item needs: id. Example: [{"id":"MUC-ABC123-1"}]
- `condition` (`string`, optional): Condition of the unit. One of: `Clean`, `CleanToBeInspected`, `Dirty`.
- `connectedUnits` (`array`, optional): The list of units this unit is composed of. Each item needs: unitId. Example: [{"unitId":"101"}]
- `unitGroupId` (`string`, optional): The id of the unit group.

Example input: `{"description":{"en":"Spacious double room"},"maxPersons":1,"name":"<name>","propertyId":"<propertyId>"}`

### `apaleo_create_unit_group`

Create Unit Group · Write

Create a unit group (room type) in a property.
Returns an object with `id`.
Use to define a new room type before adding units to it.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `code` (`string`, required): The code for the unit group that can be shown in reports and table views.
- `description` (`object`, required): The description for the unit group. Provide a map of two-letter language code to text. Example: {"en":"Spacious double room"}
- `maxPersons` (`integer`, required): Maximum number of persons for the unit group.
- `name` (`object`, required): The name for the unit group. Provide a map of two-letter language code to text. Example: {"en":"Deluxe Double"}
- `propertyId` (`string`, required): The id of the property where unit group will be created.
- `connectedUnitGroups` (`array`, optional): The list of connected unit groups this unit group is composed of. Each item needs: memberCount, unitGroupId. Example: [{"unitGroupId":"MUC-DBL","memberCount":1}]
- `rank` (`integer`, optional): The unit group rank Restrictions: - Should be greater or equal to one.
- `type` (`string`, optional): The unit group type. One of: `BedRoom`, `MeetingRoom`, `EventSpace`, `ParkingLot`.

Example input: `{"code":"<code>","description":{"en":"Spacious double room"},"maxPersons":1,"name":{"en":"Deluxe Double"},"propertyId":"<propertyId>"}`

### `apaleo_create_units_bulk`

Create Units In Bulk · Write

Create several units at once with a shared name prefix and numbering.
Returns an object with `ids`.
Use to add many similar units quickly. Use create_unit for a single named unit.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `units` (`array`, required): The units of the request. Each item needs: description, maxPersons, name, propertyId. Example: [{"propertyId":"MUC","name":"Deluxe Double","description":{},"maxPersons":1}]

Example input: `{"units":[{"propertyId":"MUC","name":"Deluxe Double","description":{},"maxPersons":1}]}`

### `apaleo_mark_no_show`

Mark Reservation No-Show · Write

Mark a reservation as a no-show.
Returns no response body on success (HTTP 204).
Use after the arrival date passed without check-in.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `reservationId` (`string`, required): Id of the reservation that should be processed.

Example input: `{"reservationId":"<reservationId>"}`

### `apaleo_post_folio_charge`

Post Folio Charge · Write

Post a charge to an open folio.
Returns an object with `id`, `feeChargeIds`.
Use to bill an extra to a guest.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `amount` (`object`, required): The amount of the request. Required fields: amount, currency. Example: {"amount":99.5,"currency":"example"}
- `folioId` (`string`, required): The folio ID
- `name` (`string`, required): The name, article number, or other description of this charge.
- `serviceType` (`string`, required): The service type, used by accounting to determine the correct revenue account. One of: `Other`, `Accommodation`, `FoodAndBeverages`, `CityTax`, `SecondCityTax`.
- `vatType` (`string`, required): The VAT type, used by accounting to determine the correct vat amount and account. One of: `Null`, `VeryReduced`, `Reduced`, `Normal`, `Without`, `Special`, `Special1`, `Special2`, `ReducedCovid19`, `NormalCovid19`, `Mixed`.
- `businessDate` (`string`, optional): The business date of the charge. Defaults to the current date. In some cases you might want to post the charges to the previous business date, this is only possible until 6 AM of the current day.
- `quantity` (`integer`, optional): The count of services provided. Defaults to 1. NOTE: this field will become required 07.05.2020.
- `receipt` (`string`, optional): Receipt for this transaction.
- `subAccountId` (`string`, optional): ID of the custom sub-account to post the charge to, used by accounting to determine the correct revenue account.

Example input: `{"amount":{"amount":99.5,"currency":"example"},"folioId":"<folioId>","name":"<name>","serviceType":"Other","vatType":"Null"}`

### `apaleo_reopen_folio`

Reopen Folio · Write

Reopen a closed folio.
Returns no response body on success (HTTP 204).
Use to correct a folio that was closed.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `folioId` (`string`, required): The folio ID.

Example input: `{"folioId":"<folioId>"}`

### `apaleo_set_units_condition`

Set Units Condition · Write

Set the housekeeping condition of one or more units.
Returns no response body on success (HTTP 204).
Use to mark rooms clean, dirty or inspected.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `unitsConditions` (`array`, required): The units conditions of the request. Each item needs: condition, id. Example: [{"id":"MUC-ABC123-1","condition":"Clean"}]

Example input: `{"unitsConditions":[{"id":"MUC-ABC123-1","condition":"Clean"}]}`

### `apaleo_unassign_units`

Unassign Units · Write

Remove the assigned units from a reservation.
Returns no response body on success (HTTP 204).
Use to free a room before reassigning.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `reservationId` (`string`, required): Id of the reservation the unit should be unassigned for.

Example input: `{"reservationId":"<reservationId>"}`

### `apaleo_update_booking`

Update Booking · Write

Modify a booking with a list of JSON Patch operations.
Returns no response body on success (HTTP 204).
Use to change booking-level data such as comments.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `bookingId` (`string`, required): Id of the booking to be modified.
- `operations` (`array`, required): List of JSON Patch operations (RFC 6902) to apply, in order. Each operation has `op` (add, remove, replace, move, copy or test), `path` (JSON pointer such as /comment) and, for add and replace, a `value`. Example: [{"op":"replace","path":"/comment","value":"Late arrival expected"}].

Example input: `{"bookingId":"<bookingId>","operations":[{"op":"replace","path":"/comment","value":"Late arrival expected"}]}`

### `apaleo_update_company`

Update Company · Write

Modify a company with a list of JSON Patch operations.
Returns no response body on success (HTTP 204).
Use to change a company's contact or billing details.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `companyId` (`string`, required): The ID of the company to be modified.
- `operations` (`array`, required): List of JSON Patch operations (RFC 6902) to apply, in order. Each operation has `op` (add, remove, replace, move, copy or test), `path` (JSON pointer such as /comment) and, for add and replace, a `value`. Example: [{"op":"replace","path":"/comment","value":"Late arrival expected"}].

Example input: `{"companyId":"<companyId>","operations":[{"op":"replace","path":"/comment","value":"Late arrival expected"}]}`

### `apaleo_update_maintenance`

Update Maintenance · Write

Modify a maintenance task with a list of JSON Patch operations.
Returns no response body on success (HTTP 204).
Use to adjust the period or description.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `maintenanceId` (`string`, required): The ID of the maintenance.
- `operations` (`array`, required): List of JSON Patch operations (RFC 6902) to apply, in order. Each operation has `op` (add, remove, replace, move, copy or test), `path` (JSON pointer such as /comment) and, for add and replace, a `value`. Example: [{"op":"replace","path":"/comment","value":"Late arrival expected"}].

Example input: `{"maintenanceId":"<maintenanceId>","operations":[{"op":"replace","path":"/comment","value":"Late arrival expected"}]}`

### `apaleo_update_property`

Update Property · Write

Modify a property with a list of JSON Patch operations.
Returns no response body on success (HTTP 204).
Use to change property fields such as name or description. Read the property first with get_property.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `operations` (`array`, required): List of JSON Patch operations (RFC 6902) to apply, in order. Each operation has `op` (add, remove, replace, move, copy or test), `path` (JSON pointer such as /comment) and, for add and replace, a `value`. Example: [{"op":"replace","path":"/comment","value":"Late arrival expected"}].
- `propertyId` (`string`, required): The id of the property.

Example input: `{"operations":[{"op":"replace","path":"/comment","value":"Late arrival expected"}],"propertyId":"<propertyId>"}`

### `apaleo_update_rate_plan`

Update Rate Plan · Write

Replace a rate plan's definition.
Returns no response body on success (HTTP 204).
Use to change an existing rate plan. Send the full definition.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `cancellationPolicyId` (`string`, required): The id of the cancellation policy valid for this rate plan.
- `channelCodes` (`array`, required): The channel codes the rate plan is sold through.
- `description` (`object`, required): The description for the rate plan. Provide a map of two-letter language code to text. Example: {"en":"Spacious double room"}
- `minGuaranteeType` (`string`, required): The minimum guarantee to be provided when this rate plan is booked so the reservation will be guaranteed to the guest. One of: `PM6Hold`, `CreditCard`, `Prepayment`, `Company`.
- `name` (`object`, required): The name for the rate plan. Provide a map of two-letter language code to text. Example: {"en":"Deluxe Double"}
- `ratePlanId` (`string`, required): The id of the rate plan.
- `accountingConfigs` (`array`, optional): The collection of accounting configs with validity periods. Each item needs: serviceType, validFrom, vatType. Example: [{"vatType":"Null","serviceType":"Other","validFrom":"2026-11-01"}]
- `ageCategories` (`array`, optional): Additional charges per age category. Each item needs: id, surcharges. Example: [{"id":"MUC-ABC123-1","surcharges":[{"adults":2,"value":99.5}]}]
- `bookingPeriods` (`array`, optional): Time periods when the rate plan is bookable. Each item needs: from, to. Example: [{"from":"2026-11-01T00:00:00Z","to":"2026-11-01T00:00:00Z"}]
- `companies` (`array`, optional): Companies that can use this rate plan. Each item needs: id. Example: [{"id":"MUC-ABC123-1"}]
- `includedServices` (`array`, optional): Services that are included in the rate plan. Each item needs: grossPrice, serviceId. Example: [{"serviceId":"BRK","grossPrice":{"amount":99.5,"currency":"example"}}]
- `isSubjectToCityTax` (`boolean`, optional): Whether the rate plan is subject to city tax or not. Default value is `true`.
- `marketSegmentId` (`string`, optional): The id of the market segment for this rate plan.
- `noShowPolicyId` (`string`, optional): The id of the no-show policy valid for this rate plan.
- `priceCalculationMode` (`string`, optional): The calculation mode is used when calculating the adults' surcharges and derived rates. Defaults to Truncate. Example: for a rate of 125.99 and a surcharge of +10%, when Truncate is selected, the result would be 125.99 + 12 = 137.99 When Round is selected, the result would be 125.99 + 12.60 = 138.59. One of: `Truncate`, `Round`.
- `pricingRule` (`object`, optional): The pricing rule of the request. Required fields: baseRatePlanId, type, value. Example: {"baseRatePlanId":"MUC-ABC123-1","type":"Absolute","value":99.5}
- `promoCodes` (`array`, optional): The rate codes for promotional and hidden rates. If at least one code is set the rate will be not publicly visible anymore and only be offered when one of the promo codes is given in the offer request. For backward compatibility it is still not possible to set multiple promo codes.
- `restrictions` (`object`, optional): The restrictions of the request.
- `surcharges` (`array`, optional): Additional charges for more than single occupancy. The percent or absolute value will be added to the manually defined or calculated derived rates. The values for 'adults' must be unique within the list and starting from occupancy of 2 adults. Values higher than the maximum unit group occupancy will be silently ignored. The surcharges are required for all possible occupancies defined by the 'MaxPersons' of the unit group. Each item needs: adults, type, value. Example: [{"adults":2,"type":"Absolute","value":99.5}]

Example input: `{"cancellationPolicyId":"<cancellationPolicyId>","channelCodes":[],"description":{"en":"Spacious double room"},"minGuaranteeType":"PM6Hold","name":{"en":"Deluxe Double"},"ratePlanId":"<ratePlanId>"}`

### `apaleo_update_rates`

Update Rates · Write

Set the rates of a rate plan for given time slices, replacing existing values.
Returns no response body on success (HTTP 204).
Use to push new prices for a rate plan and unit group.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `ratePlanId` (`string`, required): The id of the rate plan.
- `rates` (`array`, required): List of rates. Each item needs: from, to. Example: [{"from":"2026-11-01T00:00:00Z","to":"2026-11-01T00:00:00Z"}]

Example input: `{"ratePlanId":"<ratePlanId>","rates":[{"from":"2026-11-01T00:00:00Z","to":"2026-11-01T00:00:00Z"}]}`

### `apaleo_update_reservation`

Update Reservation · Write

Modify a reservation with a list of JSON Patch operations.
Returns no response body on success (HTTP 204).
Use to change guest details, comments or other fields. Use amend_reservation for dates, rooms or rates.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `operations` (`array`, required): List of JSON Patch operations (RFC 6902) to apply, in order. Each operation has `op` (add, remove, replace, move, copy or test), `path` (JSON pointer such as /comment) and, for add and replace, a `value`. Example: [{"op":"replace","path":"/comment","value":"Late arrival expected"}].
- `reservationId` (`string`, required): Id of the reservation to be modified.

Example input: `{"operations":[{"op":"replace","path":"/comment","value":"Late arrival expected"}],"reservationId":"<reservationId>"}`

### `apaleo_update_unit`

Update Unit · Write

Modify a unit with a list of JSON Patch operations.
Returns no response body on success (HTTP 204).
Use to rename a unit or change its description or attributes.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `operations` (`array`, required): List of JSON Patch operations (RFC 6902) to apply, in order. Each operation has `op` (add, remove, replace, move, copy or test), `path` (JSON pointer such as /comment) and, for add and replace, a `value`. Example: [{"op":"replace","path":"/comment","value":"Late arrival expected"}].
- `unitId` (`string`, required): The id of the unit.

Example input: `{"operations":[{"op":"replace","path":"/comment","value":"Late arrival expected"}],"unitId":"<unitId>"}`

### `apaleo_update_unit_group`

Update Unit Group · Write

Replace a unit group's definition.
Returns no response body on success (HTTP 204).
Use to change a room type's name, capacity or description. Send the full definition.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `description` (`object`, required): The description for the unit group. Provide a map of two-letter language code to text. Example: {"en":"Spacious double room"}
- `name` (`object`, required): The name for the unit group. Provide a map of two-letter language code to text. Example: {"en":"Deluxe Double"}
- `unitGroupId` (`string`, required): The id of the unit group.
- `connectedUnitGroups` (`array`, optional): The list of connected unit groups this unit group is composed of. Each item needs: memberCount, unitGroupId. Example: [{"unitGroupId":"MUC-DBL","memberCount":1}]
- `maxPersons` (`integer`, optional): Maximum number of persons for the unit group. If this value is increased, the surcharges for the related rate plans must be specified in order for the rate plans to be sellable for the new possible occupancies.
- `rank` (`integer`, optional): The unit group rank Restrictions: - Should be greater or equal to one.

Example input: `{"description":{"en":"Spacious double room"},"name":{"en":"Deluxe Double"},"unitGroupId":"<unitGroupId>"}`

### `apaleo_delete_maintenance`

Delete Maintenance · Destructive

Delete a maintenance task.
Returns no response body on success (HTTP 204).
Use when the work is cancelled.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `maintenanceId` (`string`, required): The ID of the maintenance.

Example input: `{"maintenanceId":"<maintenanceId>"}`

### `apaleo_delete_rate_plan`

Delete Rate Plan · Destructive

Permanently delete a rate plan.
Returns no response body on success (HTTP 204).
Use only for rate plans without reservations.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `ratePlanId` (`string`, required): The id of the rate plan.

Example input: `{"ratePlanId":"<ratePlanId>"}`

### `apaleo_delete_unit`

Delete Unit · Destructive

Permanently delete a unit.
Returns no response body on success (HTTP 204).
Use only for units that were created by mistake. Archived or in-use units cannot be removed.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `unitId` (`string`, required): The id of the unit.

Example input: `{"unitId":"<unitId>"}`

### `apaleo_delete_unit_group`

Delete Unit Group · Destructive

Permanently delete a unit group.
Returns no response body on success (HTTP 204).
Use only for room types with no units or reservations.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `unitGroupId` (`string`, required): The id of the unit group.

Example input: `{"unitGroupId":"<unitGroupId>"}`

## Related

Other Productivity connectors ([all 203](/agentkit/connectors/?category=productivity)):

- [Slack](/agentkit/connectors/slack/): Scalekit connector, OAuth, 96 tools
- [Notion](/agentkit/connectors/notion/): Scalekit connector, OAuth, 51 tools
- [Google Workspace (DWD)](/agentkit/connectors/googledwd/): Scalekit connector, Service account, 100 tools


---

## More Scalekit documentation

| Resource | What it contains | When to use it |
|----------|-----------------|----------------|
| [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content |
| [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas |
| [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |
