# API Operations

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

## Accounts

| Operation                                                                                                | Description                                                                           |
| -------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- |
| [Merge accounts](/connector-api/operations/accounts.md#merge-accounts)                                   | Merges two or more accounts of the same account type together                         |
| [Update accounts](/connector-api/operations/accounts.md#update-accounts)                                 | Updates one or more existing accounts, i.e. customer, company                         |
| [Upload and link file to account](/connector-api/operations/accounts.md#upload-and-link-file-to-account) | Uploads a file and links it to the specified account                                  |
| [Get all addresses](/connector-api/operations/addresses.md#get-all-addresses)                            | Returns all addresses associated with the specified accounts within the enterprise    |
| [Add addresses](/connector-api/operations/addresses.md#add-addresses)                                    | Adds a new address to the system and assigns it to a specified account                |
| [Update addresses](/connector-api/operations/addresses.md#update-addresses)                              | Updates an existing address in the system assigned to a specified account             |
| [Delete addresses](/connector-api/operations/addresses.md#delete-addresses)                              | Deletes selected addresses                                                            |
| [Get all account notes](/connector-api/operations/accountnotes.md#get-all-account-notes)                 | Returns all the account notes associated with the specified accounts within the chain |
| [Add account notes](/connector-api/operations/accountnotes.md#add-account-notes)                         | Adds new account notes to the system and assigns it to specified accounts             |
| [Update account notes](/connector-api/operations/accountnotes.md#update-account-notes)                   | Updates existing account notes                                                        |
| [Delete account notes](/connector-api/operations/accountnotes.md#delete-account-notes)                   | Deletes selected account notes                                                        |

## Billing Automations

| Operation                                                                                                                      | Description                                          |
| ------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------- |
| [Get all billing automations](/connector-api/operations/billingautomations.md#get-all-billing-automations)                     | Returns all billing automations of the enterprise    |
| [Add billing automations](/connector-api/operations/billingautomations.md#add-billing-automations)                             | Adds new billing automations                         |
| [Update billing automations](/connector-api/operations/billingautomations.md#update-billing-automations)                       | Updates selected billing automations                 |
| [Update billing automation assignments](/connector-api/operations/billingautomations.md#update-billing-automation-assignments) | Updates assignments for selected billing automations |
| [Delete billing automations](/connector-api/operations/billingautomations.md#delete-billing-automations)                       | Deletes selected billing automations                 |

## Configuration

| Operation                                                                                         | Description                                              |
| ------------------------------------------------------------------------------------------------- | -------------------------------------------------------- |
| [Get configuration](/connector-api/operations/configuration.md#get-configuration)                 | Returns configuration of the enterprise and the client   |
| [Get all countries](/connector-api/operations/countries.md#get-all-countries)                     | Returns all countries supported by the API               |
| [Get all currencies](/connector-api/operations/currencies.md#get-all-currencies)                  | Returns all currencies supported by the API              |
| [Get all tax environments](/connector-api/operations/taxenvironments.md#get-all-tax-environments) | Returns all tax environments supported by the API        |
| [Get all taxations](/connector-api/operations/taxations.md#get-all-taxations)                     | Returns all taxations supported in tax environments      |
| [Get all languages](/connector-api/operations/languages.md#get-all-languages)                     | Returns all languages supported by the API               |
| [Get language texts](/connector-api/operations/languages.md#get-language-texts)                   | Returns translations of texts in the specified languages |
| [Get image URLs](/connector-api/operations/images.md#get-image-URLs)                              | Returns URLs of the specified images                     |

## Customers

| Operation                                                                                               | Description                                                                                                                                                                                    |
| ------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [Get all customers](/connector-api/operations/customers.md#get-all-customers)                           | Returns all customers filtered by identifiers, emails, names and other filters                                                                                                                 |
| [Search customers](/connector-api/operations/customers.md#search-customers)                             | Searches for customers that are active at the moment in the enterprise, e.g. companions of checked-in reservations or paymasters                                                               |
| [Get customers relationships](/connector-api/operations/customers.md#get-customers-relationships)       | **Restricted!** Returns relationships between customers                                                                                                                                        |
| [~~Get customers open items~~](/connector-api/operations/customers.md#get-customers-open-items)         | **Deprecated!** Use [Get all payments](/connector-api/operations/payments.md#get-all-payments) and [Get all order items](/connector-api/operations/orderitems.md#get-all-order-items) instead. |
| [Add customer](/connector-api/operations/customers.md#add-customer)                                     | Adds a new customer to the system and returns details of the added customer                                                                                                                    |
| [Update customer](/connector-api/operations/customers.md#update-customer)                               | Updates personal information of a customer                                                                                                                                                     |
| [~~Merge customers~~](/connector-api/operations/customers.md#merge-customers)                           | **Deprecated!** Please use [Merge accounts](/connector-api/operations/accounts.md#merge-accounts) instead.                                                                                     |
| [Add customer file](/connector-api/operations/customers.md#add-customer-file)                           | Attaches the specified file to the customer profile                                                                                                                                            |
| [Get all identity documents](/connector-api/operations/identitydocuments.md#get-all-identity-documents) | Returns all identity documents for the specified customers                                                                                                                                     |
| [Adds identity documents](/connector-api/operations/identitydocuments.md#add-identity-documents)        | Adds new identity documents                                                                                                                                                                    |
| [Update identity documents](/connector-api/operations/identitydocuments.md#update-identity-documents)   | Updates specified identity documents                                                                                                                                                           |
| [Delete identity documents](/connector-api/operations/identitydocuments.md#delete-identity-documents)   | Deletes specified identity documents                                                                                                                                                           |
| [Clear identity documents](/connector-api/operations/identitydocuments.md#clear-identity-documents)     | Deletes all identity documents for the specified customers                                                                                                                                     |

## Device integration

| Operation                                                                                                | Description                                                                               |
| -------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- |
| [Get all devices](/connector-api/operations/devices.md#get-all-devices)                                  | Returns all devices in the enterprise                                                     |
| [Get all commands](/connector-api/operations/commands.md#get-all-commands)                               | Returns all commands the are still active from the client application point of view       |
| [Get all commands by ids](/connector-api/operations/commands.md#get-all-commands-by-ids)                 | Returns all commands by their identifiers                                                 |
| [Get all fiscal machine commands](/connector-api/operations/commands.md#get-all-fiscal-machine-commands) | **Restricted!** Returns fiscal machine commands by their identifiers or state.            |
| [Add printer command](/connector-api/operations/commands.md#add-printer-command)                         | Adds a new printer command representing printing of the specified document on a printer   |
| [Add key cutter command](/connector-api/operations/commands.md#add-key-cutter-command)                   | Adds a new key cutter command representing cutting of a key for the specified reservation |
| [Add payment command](/connector-api/operations/commands.md#add-payment-command)                         | **Restricted!** Adds a new Mews Payment Terminal command                                  |
| [Update command](/connector-api/operations/commands.md#update-command)                                   | Updates state of a command                                                                |

## Enterprises

| Operation                                                                                                                                  | Description                                                                                                |
| ------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------- |
| [Get all enterprises](/connector-api/operations/enterprises.md#get-all-enterprises)                                                        | Returns all enterprises accessible to a supplied access token                                              |
| [Get all companies](/connector-api/operations/companies.md#get-all-companies)                                                              | Returns all company profiles of the enterprise, possibly filtered by identifiers, names or other filters   |
| [Add company](/connector-api/operations/companies.md#add-company)                                                                          | Adds a new company to the enterprise                                                                       |
| [Update company](/connector-api/operations/companies.md#update-company)                                                                    | Updates information of the company                                                                         |
| [Delete companies](/connector-api/operations/companies.md#delete-companies)                                                                | Deletes selected companies                                                                                 |
| [Get all company contracts](/connector-api/operations/companycontracts.md#get-all-company-contracts)                                       | Returns all contracts between the enterprise and other companies                                           |
| [Add company contracts](/connector-api/operations/companycontracts.md#add-company-contracts)                                               | Adds new company contracts to the enterprise                                                               |
| [Update company contracts](/connector-api/operations/companycontracts.md#update-company-contracts)                                         | Updates selected company contracts                                                                         |
| [Delete company contracts](/connector-api/operations/companycontracts.md#delete-company-contracts)                                         | Deletes selected company contracts                                                                         |
| [Get all departments](/connector-api/operations/departments.md#get-all-departments)                                                        | Returns all departments of an enterprise associated with the connector integration                         |
| [Get all counters](/connector-api/operations/counters.md#get-all-counters)                                                                 | Returns all counters of an enterprise associated with the connector integration                            |
| [Get all outlets](/connector-api/operations/outlets.md#get-all-outlets)                                                                    | Returns all outlets of an enterprise associated with the connector integration                             |
| [Get all resources](/connector-api/operations/resources.md#get-all-resources)                                                              | Returns all resources of an enterprise associated with the connector integration                           |
| [Get resources' occupancy state](/connector-api/operations/resources.md#get-resources-occupancy-state)                                     | Returns occupancy state of the specified resources in the given time interval                              |
| [Update resources](/connector-api/operations/resources.md#update-resources)                                                                | Updates details of the resources                                                                           |
| [Get all resource blocks](/connector-api/operations/resourceblocks.md#get-all-resource-blocks)                                             | Returns all resource blocks (out of order blocks or internal use blocks)                                   |
| [Add resource block](/connector-api/operations/resourceblocks.md#add-resource-block)                                                       | Adds a new resource block to the specified resource for a defined period of time                           |
| [Delete resource blocks](/connector-api/operations/resourceblocks.md#delete-resource-blocks)                                               | Removes specified resource blocks from the resources                                                       |
| [Add task](/connector-api/operations/tasks.md#add-task)                                                                                    | Adds a new task to the enterprise, optionally to a specified department                                    |
| [Close task](/connector-api/operations/tasks.md#close-tasks)                                                                               | Closes one or more tasks.                                                                                  |
| [Get all tasks](/connector-api/operations/tasks.md#get-all-tasks)                                                                          | Returns all tasks of the enterprise, filtered by identifiers or other filters                              |
| [Get all resource categories](/connector-api/operations/resourcecategories.md#get-all-resource-categories)                                 | Returns all resource categories of an enterprise associated with the connector integration                 |
| [Get all resource category assignments](/connector-api/operations/resourcecategories.md#get-all-resource-category-assignments)             | Returns all resource category assignments of an enterprise associated with the connector integration       |
| [Get all resource category image assignments](/connector-api/operations/resourcecategories.md#get-all-resource-category-image-assignments) | Returns all resource category image assignments of an enterprise associated with the connector integration |
| [Get all resource features](/connector-api/operations/resourcefeatures.md#get-all-resource-features)                                       | Returns all resource features of an enterprise associated with the connector integration                   |
| [Get all resource feature assignments](/connector-api/operations/resourcefeatures.md#get-all-resource-feature-assignments)                 | Returns all resource feature assignments of an enterprise associated with the connector integration        |

## Exports

| Operation                                                               | Description                                                              |
| ----------------------------------------------------------------------- | ------------------------------------------------------------------------ |
| [Get all exports](/connector-api/operations/exports.md#get-all-exports) | **Restricted!** Returns all exports filtered by their unique identifiers |
| [Add export](/connector-api/operations/exports.md#add-export)           | **Restricted!** Create a pending export                                  |

## Finance

| Operation                                                                                                                         | Description                                                                                                                                                                                           |
| --------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [Get all exchange rates](/connector-api/operations/exchangerates.md#get-all-exchange-rates)                                       | Returns all available exchange rates among currencies of the enterprise                                                                                                                               |
| [Get all cashiers](/connector-api/operations/cashiers.md#get-all-cashiers)                                                        | Returns all cashiers in the enterprise                                                                                                                                                                |
| [Get all cashier transactions](/connector-api/operations/cashiertransactions.md#get-all-cashier-transactions)                     | Returns all cashier transactions created within the specified interval                                                                                                                                |
| [Get all accounting categories](/connector-api/operations/accountingcategories.md#get-all-accounting-categories)                  | Returns all accounting categories of the enterprise associated with the connector integration                                                                                                         |
| [~~Get all accounting items~~](/connector-api/operations/accountingitems.md#get-all-accounting-items)                             | **Deprecated!** Please use [Get all payments](/connector-api/operations/payments.md#get-all-payments) and [Get all order items](/connector-api/operations/orderitems.md#get-all-order-items) instead. |
| [Update accounting items](/connector-api/operations/accountingitems.md#update-accounting-items)                                   | Updates specified accounting item                                                                                                                                                                     |
| [Get all bills](/connector-api/operations/bills.md#get-all-bills)                                                                 | Returns all bills, possibly filtered by customers, identifiers and other filters                                                                                                                      |
| [Add bill](/connector-api/operations/bills.md#add-bill)                                                                           | Creates new empty bill assigned to specified account                                                                                                                                                  |
| [Update bills](/connector-api/operations/bills.md#update-bills)                                                                   | **Restricted!** Updates account assignments of one or more open bills                                                                                                                                 |
| [Delete bill](/connector-api/operations/bills.md#delete-bill)                                                                     | Removes selected bills                                                                                                                                                                                |
| [Close bill](/connector-api/operations/bills.md#close-bill)                                                                       | Closes a bill so no further modification to it is possibles                                                                                                                                           |
| [Get bill PDF](/connector-api/operations/bills.md#get-bill-PDF)                                                                   | Creates a PDF version of the specified bill                                                                                                                                                           |
| [Get all outlet items](/connector-api/operations/outletitems.md#get-all-outlet-items)                                             | Returns all outlet items of the enterprise that were consumed (posted) or will be consumed within the specified interval                                                                              |
| [Get all credit cards](/connector-api/operations/creditcards.md#get-all-credit-cards)                                             | Returns all credit cards, possibly filtered by identifiers, customers or other filters                                                                                                                |
| [Charge credit card](/connector-api/operations/creditcards.md#charge-credit-card)                                                 | Creates payment for specified customer credit card and charges the credit card via a gateway                                                                                                          |
| [Add tokenized credit card](/connector-api/operations/creditcards.md#add-tokenized-credit-card)                                   | Adds a new tokenized credit card to the specified customer                                                                                                                                            |
| [Disable gateway credit card](/connector-api/operations/creditcards.md#disable-gateway-credit-card)                               | **Restricted!** Disables a credit card from being used for payments                                                                                                                                   |
| <p><a href="/pages/FZws7fD1AHzT5abVIOOo#get-all-preauthorizations-by-customers">Get all preauthorizations<br>by customers</a></p> | Returns all preauthorizations of specified customers                                                                                                                                                  |
| [Add credit card payment](/connector-api/operations/payments.md#add-credit-card-payment)                                          | Adds a new credit card payment to a bill of the specified customer                                                                                                                                    |
| [Add external payment](/connector-api/operations/payments.md#add-external-payment)                                                | Adds a new external payment to a bill of the specified customer                                                                                                                                       |
| [Add alternative payment](/connector-api/operations/payments.md#add-alternative-payment)                                          | Adds a new alternative payment to a specified customer                                                                                                                                                |
| [Get all payments](/connector-api/operations/payments.md#get-all-payments)                                                        | Returns all payments, filtered by various parameters                                                                                                                                                  |
| [Get all payment requests](/connector-api/operations/paymentrequests.md#get-all-payment-requests)                                 | Returns all payment requests                                                                                                                                                                          |
| [Add payment requests](/connector-api/operations/paymentrequests.md#add-payment-requests)                                         | Adds new payment requests for specified customers                                                                                                                                                     |
| [Cancel payment requests](/connector-api/operations/paymentrequests.md#cancel-payment-requests)                                   | Cancels specified pending payment requests                                                                                                                                                            |
| [Add payment method request](/connector-api/operations/paymentmethodrequests.md#add-payment-method-request)                       | Adds a payment method request to prompt a customer or company to provide a payment method                                                                                                             |
| [Add outlet bills](/connector-api/operations/outletbills.md#add-outlet-bills)                                                     | Adds new outlet bills with their items                                                                                                                                                                |
| [Get all order items](/connector-api/operations/orderitems.md#get-all-order-items)                                                | Returns all order items                                                                                                                                                                               |
| [Cancel order items](/connector-api/operations/orderitems.md#cancel-order-items)                                                  | **Restricted!** Cancels specified order items                                                                                                                                                         |
| [Refund payment](/connector-api/operations/payments.md#refund-payment)                                                            | Refunds a specified payment                                                                                                                                                                           |
| [Add payment plan](/connector-api/operations/paymentplans.md#add-payment-plan)                                                    | **Restricted!** Adds a payment plan connected to a `Reservation`; used for recurring payments                                                                                                         |
| [Add billing automation payment plan](/connector-api/operations/paymentplans.md#add-billing-automation-payment-plan)              | **Restricted!** Adds a payment plan connected to a billing automation                                                                                                                                 |
| [Get all ledger balances](/connector-api/operations/ledgerbalances.md#get-all-ledger-balances)                                    | Returns balances of specified ledgers for each day                                                                                                                                                    |

## Loyalty

| Operation                                                                                                  | Description                                       |
| ---------------------------------------------------------------------------------------------------------- | ------------------------------------------------- |
| [Get all loyalty programs](/connector-api/operations/loyaltyprograms.md#get-all-loyalty-programs)          | Returns all loyalty programs of the enterprise    |
| [Add loyalty programs](/connector-api/operations/loyaltyprograms.md#add-loyalty-programs)                  | Adds new loyalty programs                         |
| [Update loyalty programs](/connector-api/operations/loyaltyprograms.md#update-loyalty-programs)            | Updates selected loyalty programs                 |
| [Delete loyalty programs](/connector-api/operations/loyaltyprograms.md#delete-loyalty-programs)            | Deletes selected loyalty programs                 |
| [Get all loyalty memberships](/connector-api/operations/loyaltymemberships.md#get-all-loyalty-memberships) | Returns all loyalty memberships of the enterprise |
| [Add loyalty memberships](/connector-api/operations/loyaltymemberships.md#add-loyalty-memberships)         | Adds new loyalty memberships                      |
| [Update loyalty memberships](/connector-api/operations/loyaltymemberships.md#update-loyalty-memberships)   | Updates selected loyalty memberships              |
| [Delete loyalty memberships](/connector-api/operations/loyaltymemberships.md#delete-loyalty-memberships)   | Deletes selected loyalty memberships              |
| [Get all loyalty tiers](/connector-api/operations/loyaltytiers.md#get-all-loyalty-tiers)                   | Returns all loyalty tiers of the enterprise       |
| [Add loyalty tiers](/connector-api/operations/loyaltytiers.md#add-loyalty-tiers)                           | Adds new loyalty tiers                            |
| [Update loyalty tiers](/connector-api/operations/loyaltytiers.md#update-loyalty-tiers)                     | Updates selected loyalty tiers                    |
| [Delete loyalty tiers](/connector-api/operations/loyaltytiers.md#delete-loyalty-tiers)                     | Deletes selected loyalty tiers                    |

## Customer messaging

| Operation                                                                                      | Description                                                      |
| ---------------------------------------------------------------------------------------------- | ---------------------------------------------------------------- |
| [Get all message threads](/connector-api/operations/messagethreads.md#get-all-message-threads) | Get all message threads that you have created                    |
| [Add message thread](/connector-api/operations/messagethreads.md#add-message-thread)           | Creates a new message thread on behalf of the specified customer |
| [Get all messages](/connector-api/operations/messages.md#get-all-messages)                     | Get all messages belonging to the specified message threads      |
| [Add messages](/connector-api/operations/messages.md#add-messages)                             | Add the specified messages to the specified message threads      |

## Reservations

| Operation                                                                                                                               | Description                                                                                                                                                |
| --------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [Get all reservations (ver 2023-06-06)](/connector-api/operations/reservations.md#get-all-reservations-ver-2023-06-06)                  | Returns all reservations specified by filters                                                                                                              |
| [~~Get all reservations (ver 2017-04-12)~~](/connector-api/operations/reservations.md#get-all-reservations-ver-2017-04-12)              | **Deprecated!** Please use [Get all reservations (ver 2023-06-06)](/connector-api/operations/reservations.md#get-all-reservations-ver-2023-06-06) instead. |
| [~~Get all reservation items~~](/connector-api/operations/reservations.md#get-all-reservation-items)                                    | **Deprecated!** Please use [Get all order items](/connector-api/operations/orderitems.md#get-all-order-items) instead.                                     |
| [Price reservations](/connector-api/operations/reservations.md#price-reservations)                                                      | Returns prices of reservations with the specified parameters                                                                                               |
| [Add reservations](/connector-api/operations/reservations.md#add-reservations)                                                          | Adds the specified reservations as a single group                                                                                                          |
| [Update reservations](/connector-api/operations/reservations.md#update-reservations)                                                    | Updates information about the specified reservations                                                                                                       |
| [Confirm reservations](/connector-api/operations/reservations.md#confirm-reservations)                                                  | Marks all specified reservations as `Confirmed`                                                                                                            |
| [Start reservation](/connector-api/operations/reservations.md#start-reservation)                                                        | Marks a reservation as `Started` (checked in)                                                                                                              |
| [Process reservation](/connector-api/operations/reservations.md#process-reservation)                                                    | Marks a reservation as `Processed` (checked out)                                                                                                           |
| [Cancel reservation](/connector-api/operations/reservations.md#cancel-reservation)                                                      | Cancels all reservation with specified identifiers                                                                                                         |
| [Update reservation customer](/connector-api/operations/reservations.md#update-reservation-customer)                                    | Updates customer of a reservation                                                                                                                          |
| [Update reservation interval](/connector-api/operations/reservations.md#update-reservation-interval)                                    | Updates reservation interval (start, end or both)                                                                                                          |
| [Add reservation companion](/connector-api/operations/reservations.md#add-reservation-companion)                                        | Adds a customer as a companion to the reservation                                                                                                          |
| [Delete reservation companion](/connector-api/operations/reservations.md#delete-reservation-companion)                                  | Removes customer companionship from the reservation                                                                                                        |
| [Add reservation product](/connector-api/operations/reservations.md#add-reservation-product)                                            | Adds a new product order of the specified product to the reservation                                                                                       |
| [Get all source assignments (ver 2024-09-20)](/connector-api/operations/sourceassignments.md#get-all-source-assignments-ver-2024-09-20) | **Restricted!** Returns all sources associated with a reservation                                                                                          |
| [Get all source assignments](/connector-api/operations/sourceassignments.md#get-all-source-assignments)                                 | Returns all sources associated with a reservation group                                                                                                    |
| [Get all sources](/connector-api/operations/sources.md#get-all-sources)                                                                 | Returns all possible reservation sources                                                                                                                   |
| [Get all reservation groups](/connector-api/operations/reservationgroups.md#get-all-reservation-groups)                                 | Returns all reservation groups, filtered by unique identifiers and other filters                                                                           |
| [Get reservations channel manager details](/connector-api/operations/reservations.md#get-reservations-channel-manager-details)          | **Restricted!** Gets requested rate codes for the reservation                                                                                              |

## Routing rules

| Operation                                                                                    | Description                                                                                                                                                                                                                                                              |
| -------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| [~~Get all routing rules~~](/connector-api/operations/routingrules.md#get-all-routing-rules) | **Deprecated!** Use [Get all billing automations](/connector-api/operations/billingautomations.md#get-all-billing-automations) instead.                                                                                                                                  |
| [~~Add routing rules~~](/connector-api/operations/routingrules.md#add-routing-rules)         | **Deprecated!** Use [Add billing automations](/connector-api/operations/billingautomations.md#add-billing-automations) instead.                                                                                                                                          |
| [~~Update routing rules~~](/connector-api/operations/routingrules.md#update-routing-rules)   | **Deprecated!** Use [Update billing automations](/connector-api/operations/billingautomations.md#update-billing-automations) and [Update billing automation assignments](/connector-api/operations/billingautomations.md#update-billing-automation-assignments) instead. |
| [~~Delete routing rules~~](/connector-api/operations/routingrules.md#delete-routing-rules)   | **Deprecated!** Use [Delete billing automations](/connector-api/operations/billingautomations.md#delete-billing-automations) instead.                                                                                                                                    |

## Service orders

| Operation                                                                                                          | Description                                                |
| ------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------- |
| [Get all product service orders](/connector-api/operations/productserviceorders.md#get-all-product-service-orders) | Returns all product service orders                         |
| [Get all service order notes](/connector-api/operations/serviceordernotes.md#get-all-service-order-notes)          | Returns all notes associated with the given service orders |
| [Add service order notes](/connector-api/operations/serviceordernotes.md#add-service-order-notes)                  | Adds service order notes to a given service order          |
| [Update service order notes](/connector-api/operations/serviceordernotes.md#update-service-order-notes)            | Updates content of given service order notes               |
| [Delete service order notes](/connector-api/operations/serviceordernotes.md#delete-service-order-notes)            | Deletes given service order notes                          |

## Services

| Operation                                                                                                                                | Description                                                                                                              |
| ---------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| [Get all services](/connector-api/operations/services.md#get-all-services)                                                               | Returns all services offered by the enterprise                                                                           |
| [Get service availability (ver 2024-01-22)](/connector-api/operations/services.md#get-service-availability-ver-2024-01-22)               | **Restricted!** Returns selected availability and occupancy metrics of a bookable service in the specified time interval |
| [Get service availability](/connector-api/operations/services.md#get-service-availability)                                               | Returns availability of a bookable service in the specified interval                                                     |
| [Update service availability](/connector-api/operations/services.md#update-service-availability)                                         | Updates the number of available resources in the specified resource category by a certain amount                         |
| [Get all availability blocks](/connector-api/operations/availabilityblocks.md#get-all-availability-blocks)                               | Returns all availability blocks filtered by services, unique identifiers and other filter                                |
| [Add availability blocks](/connector-api/operations/availabilityblocks.md#add-availability-blocks)                                       | Adds availability blocks which are used to group related availability updates                                            |
| [Update availability blocks](/connector-api/operations/availabilityblocks.md#update-availability-blocks)                                 | Updates information about the specified availability block                                                               |
| [Delete availability blocks](/connector-api/operations/availabilityblocks.md#delete-availability-blocks)                                 | Delete availability blocks                                                                                               |
| [Get all availability adjustments](/connector-api/operations/availabilityadjustments.md#get-all-availability-adjustments)                | Get all availability adjustments                                                                                         |
| [Get all rules](/connector-api/operations/rules.md#get-all-rules)                                                                        | Returns all rules applied with the reservations                                                                          |
| [Get all business segments](/connector-api/operations/businesssegments.md#get-all-business-segments)                                     | Returns all business segments of the default service provided by the enterprise                                          |
| [Get all rates](/connector-api/operations/rates.md#get-all-rates)                                                                        | Returns all rates (pricing setups) of the default service provided by the enterprise                                     |
| [Add rates](/connector-api/operations/rates.md#add-rates)                                                                                | Adds new rates to the enterprise                                                                                         |
| [Set rates](/connector-api/operations/rates.md#set-rates)                                                                                | **Restricted!** Adds new or updates existing rates                                                                       |
| [Delete rates](/connector-api/operations/rates.md#delete-rates)                                                                          | Deletes specified rates                                                                                                  |
| [Update rate capacity offset pricing](/connector-api/operations/rates.md#update-rate-capacity-offset-pricing)                            | Updates capacity offset based pricing for specified rates                                                                |
| [Get rate pricing](/connector-api/operations/rates.md#get-rate-pricing)                                                                  | Returns prices of a rate in the specified interval                                                                       |
| [Update rate price](/connector-api/operations/rates.md#update-rate-price)                                                                | Updates price of a rate in the specified intervals                                                                       |
| [Get all rate groups](/connector-api/operations/rategroups.md#get-all-rate-groups)                                                       | Returns all rate groups filtered by rate groups or other filters                                                         |
| [Get all restrictions](/connector-api/operations/restrictions.md#get-all-restrictions)                                                   | Returns all restrictions of the default service provided by the enterprise                                               |
| [Set restrictions](/connector-api/operations/restrictions.md#set-restrictions)                                                           | Adds new restrictions with the specified conditions                                                                      |
| [Clear restrictions](/connector-api/operations/restrictions.md#clear-restrictions)                                                       | Clears restrictions which meet specified conditions over a specified time interval                                       |
| [Add order](/connector-api/operations/orders.md#add-order)                                                                               | Creates a new order with the specified products and items                                                                |
| [Get all companionships](/connector-api/operations/companionships.md#get-all-companionships)                                             | Returns all companionships based on customers, reservations or reservation groups                                        |
| [Get all resource access tokens](/connector-api/operations/resourceaccesstokens.md#get-all-resource-access-tokens)                       | Returns all resource access tokens based on resource access tokens, reservations or interval                             |
| [Add resource access tokens](/connector-api/operations/resourceaccesstokens.md#add-resource-access-tokens)                               | Adds new resource access tokens with the specified data                                                                  |
| [Update resource access tokens](/connector-api/operations/resourceaccesstokens.md#update-resource-access-tokens)                         | Updates resource access token validity intervals and permissions                                                         |
| [Delete resource access tokens](/connector-api/operations/resourceaccesstokens.md#delete-resource-access-tokens)                         | Delete specified resource access tokens                                                                                  |
| [Get all vouchers](/connector-api/operations/vouchers.md#get-all-vouchers)                                                               | Returns all rate vouchers filtered by service, voucher code or voucher identifier                                        |
| [Add vouchers](/connector-api/operations/vouchers.md#add-vouchers)                                                                       | Adds new vouchers with the specified data                                                                                |
| [Update vouchers](/connector-api/operations/vouchers.md#update-vouchers)                                                                 | Updates information about the specified vouchers                                                                         |
| [Delete vouchers](/connector-api/operations/vouchers.md#delete-vouchers)                                                                 | Delete vouchers                                                                                                          |
| [Get all voucher codes](/connector-api/operations/vouchercodes.md#get-all-voucher-codes)                                                 | Returns all voucher codes filtered by voucher or other filters                                                           |
| [Add voucher codes](/connector-api/operations/vouchercodes.md#add-voucher-codes)                                                         | Adds new voucher codes to the voucher                                                                                    |
| [Delete voucher codes](/connector-api/operations/vouchercodes.md#delete-voucher-codes)                                                   | Delete voucher codes                                                                                                     |
| [Get all age categories](/connector-api/operations/agecategories.md#get-all-age-categories)                                              | Returns all age categories filtered by service                                                                           |
| [Get all cancellation policies](/connector-api/operations/cancellationpolicies.md#get-all-cancellation-policies)                         | **Restricted!** Returns all cancellation policies filtered by services, rate groups and other filters                    |
| [Get cancellation policies by reservations](/connector-api/operations/cancellationpolicies.md#get-cancellation-policies-by-reservations) | **Restricted!** Returns cancellation policies for enterprise grouped by reservation                                      |
| [Get cancellation policies by rates](/connector-api/operations/cancellationpolicies.md#get-cancellation-policies-by-rates)               | **Restricted!** Returns cancellation policies for enterprise grouped by rate                                             |
| [Get all products](/connector-api/operations/products.md#get-all-products)                                                               | Returns all products filtered by services or product identifier                                                          |
| [Delete products](/connector-api/operations/products.md#delete-products)                                                                 | Deletes specified products                                                                                               |
| [Get product pricing](/connector-api/operations/products.md#get-product-pricing)                                                         | **Restricted!** Returns prices for a product for a specified time interval                                               |
| [Update product pricing](/connector-api/operations/products.md#update-product-pricing)                                                   | Updates product price for a given interval                                                                               |
| [Get all product categories](/connector-api/operations/productcategories.md#get-all-product-categories)                                  | Returns all products filtered by services or product category identifier                                                 |
| [Get all service overbooking limits](/connector-api/operations/serviceoverbookinglimits.md#get-all-service-overbooking-limits)           | **Restricted!** Returns all service overbooking limits                                                                   |
| [Set service overbooking limits](/connector-api/operations/serviceoverbookinglimits.md#set-service-overbooking-limits)                   | **Restricted!** Adds new service overbooking limits with the specified conditions                                        |
| [Clear service overbooking limits](/connector-api/operations/serviceoverbookinglimits.md#clear-service-overbooking-limits)               | **Restricted!** Clears service overbooking limits which meet specified conditions over a specified time interval         |


---

# 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/connector-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.
