# API Operations

This section describes all operations supported by the API, organised by theme.

## Availability

| Operation or Endpoint                                                                                                         | Description                                                                                  |
| ----------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- |
| [Get availability](/booking-engine-guide/booking-engine-api/operations/hotels.md#get-availability)                            | Get availability and pricing options for the specified hotel for the specified date interval |
| [Get availability blocks](/booking-engine-guide/booking-engine-api/operations/availability-blocks.md#get-availability-blocks) | Get details of the availability blocks for the given hotel.                                  |

## Configuration

| Operation or Endpoint                                                                                                | Description                                                                                                                                                                |
| -------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [Get configuration](/booking-engine-guide/booking-engine-api/operations/configuration.md#get-configuration)          | Get configuration data for the specified booking engine instances; this operation can be called initially to fetch data which may be important during the booking workflow |
| [Get hotels](/booking-engine-guide/booking-engine-api/operations/hotels.md#get-hotels)                               | Get hotels data for a single specified hotel; this operation can be called initially to fetch data which may be important during the booking workflow                      |
| [Get payment configuration](/booking-engine-guide/booking-engine-api/operations/hotels.md#get-payment-configuration) | Fetch payment configuration parameters for the specified hotel                                                                                                             |

## Payment cards

| Operation or Endpoint                                                                                                 | Description                                                                         |
| --------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- |
| [Get payment cards](/booking-engine-guide/booking-engine-api/operations/payment-cards.md#get-payment-cards)           | Fetch details about the listed payment cards, in particular the Authorization state |
| [Authorize payment card](/booking-engine-guide/booking-engine-api/operations/payment-cards.md#authorize-payment-card) | Request authorization of the specified payment card                                 |

## Reservations

| Operation or Endpoint                                                                                                          | Description                                                                               |
| ------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------- |
| [Get reservations pricing](/booking-engine-guide/booking-engine-api/operations/reservations.md#get-reservations-pricing)       | Get a price quotation for a specific hotel, date interval, room category and person count |
| [Get reservation price](/booking-engine-guide/booking-engine-api/operations/reservations.md#get-reservation-price)             | Get final price of the specified reservations                                             |
| [Create reservation group](/booking-engine-guide/booking-engine-api/operations/reservation-groups.md#create-reservation-group) | Create a group of one or more reservations, i.e. make a reservation                       |
| [Get reservation group](/booking-engine-guide/booking-engine-api/operations/reservation-groups.md#get-reservation-group)       | Fetch details of the specified reservation group                                          |

## Services

| Operation or Endpoint                                                                                                  | Description                                                                                  |
| ---------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- |
| [Get services availability](/booking-engine-guide/booking-engine-api/operations/services.md#get-services-availability) | Get availability for the specified service for each time unit in the specified date interval |
| [Get services pricing](/booking-engine-guide/booking-engine-api/operations/services.md#get-services-pricing)           | Get pricing for the specified service for each time unit in the specified date interval      |

## Vouchers

| Operation or Endpoint                                                                                | Description                                             |
| ---------------------------------------------------------------------------------------------------- | ------------------------------------------------------- |
| [Validate voucher](/booking-engine-guide/booking-engine-api/operations/vouchers.md#validate-voucher) | Determine if the specified voucher code is valid or not |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mews.com/booking-engine-guide/booking-engine-api/operations.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.