# Changelog

## 4th December 2025

* [Products:](https://github.com/MewsSystems/poc-open-api-docs/blob/main/pos-api/operations/products.md#get-product)
  * Added new operation for retrieving a single product by ID.
* [Orders:](https://github.com/MewsSystems/poc-open-api-docs/blob/main/pos-api/operations/orders.md#get-orders)
  * Clarified new `state` field and its role in constraining `status` (fulfillment status).
* [Invoices:](https://github.com/MewsSystems/poc-open-api-docs/blob/main/pos-api/operations/invoices.md#get-invoices)
  * Updated embedded `order_attributes` section to reflect the `state` and `status` definitions.
* [Payments:](https://github.com/MewsSystems/poc-open-api-docs/blob/main/pos-api/operations/payments.md#create-a-payment)
  * Updated embedded `order_attributes` section to reflect the `state` and `status` definitions.
* [Webhooks:](/pos-api/events/webhooks.md)
  * Added `order.state.updated` event for changes to order state.
  * Updated `order.status.updated` event to reflect actual statuses.

## 25th November 2025

* [Webhooks:](/pos-api/events/webhooks.md)
  * Added `order.total.updated` event for changes to order totals due to gratuity (tip) or correction amount updates.
  * Added `orders.payments.added` event when a payment is successfully added to an order.

## 24th November 2025

* [Get menus:](https://github.com/MewsSystems/poc-open-api-docs/blob/main/pos-api/operations/menus.md#get-menus)
  * New operation added for retrieving a list of menus.
* [Get menu details:](https://github.com/MewsSystems/poc-open-api-docs/blob/main/pos-api/operations/menus.md#get-menu-details)
  * New operation added for retrieving details of a specific menu, including sections and associated outlets.

## 20th November 2025

* [Get invoice item:](https://github.com/MewsSystems/poc-open-api-docs/blob/main/pos-api/operations/invoiceitems.md#get-invoice-items)
  * Updated JSON examples to use consistent 2-decimal place format for numeric values (e.g., "17.00" instead of "17.0").
* [Update order:](https://github.com/MewsSystems/poc-open-api-docs/blob/main/pos-api/operations/orders.md#update-order)
  * Enhanced documentation with clarification on item identifiers: use `tempId` for new items and `id` (UUID) for existing items.
  * Added example showing how to update existing order items using `id` in the request body.
* [Digital ordering:](/pos-api/use-cases/digital-ordering.md)
  * Added room charge section with documentation on room number validation for payments.
  * Clarified that `roomNumber` is only permitted when using the `room_charge` payment method.

## 7th November 2025

* [API Operations:](/pos-api/operations.md)
  * Updated operations index to include all missing operations.
  * Added missing order operations: [Get order](https://github.com/MewsSystems/poc-open-api-docs/blob/main/pos-api/operations/orders.md#get-order), [Create order](https://github.com/MewsSystems/poc-open-api-docs/blob/main/pos-api/operations/orders.md#create-order), [Update order](https://github.com/MewsSystems/poc-open-api-docs/blob/main/pos-api/operations/orders.md#update-order).
  * Added missing register operation: [Get register](https://github.com/MewsSystems/poc-open-api-docs/blob/main/pos-api/operations/registers.md#get-register).
  * Added missing webhook operations: [Get webhook endpoints](https://github.com/MewsSystems/poc-open-api-docs/blob/main/pos-api/operations/webhookendpoints.md#get-webhook-endpoints), [Update webhook endpoint](https://github.com/MewsSystems/poc-open-api-docs/blob/main/pos-api/operations/webhookendpoints.md#update-webhook-endpoint).
  * Added missing operations: [Get modifier sets](https://github.com/MewsSystems/poc-open-api-docs/blob/main/pos-api/operations/modifiersets.md#get-modifier-sets), [Get modifier set](https://github.com/MewsSystems/poc-open-api-docs/blob/main/pos-api/operations/modifiersets.md#get-modifier-set), [Get outlets](https://github.com/MewsSystems/poc-open-api-docs/blob/main/pos-api/operations/outlets.md#get-outlets), [Get payment methods](https://github.com/MewsSystems/poc-open-api-docs/blob/main/pos-api/operations/paymentmethods.md#get-payment-methods), [Create payment](https://github.com/MewsSystems/poc-open-api-docs/blob/main/pos-api/operations/payments.md#create-a-payment), [Get product bundles](https://github.com/MewsSystems/poc-open-api-docs/blob/main/pos-api/operations/productbundles.md#get-product-bundles), [Get promo codes](https://github.com/MewsSystems/poc-open-api-docs/blob/main/pos-api/operations/promocodes.md#get-promo-codes), [Get revenue centers](https://github.com/MewsSystems/poc-open-api-docs/blob/main/pos-api/operations/revenuecenters.md#get-revenue-centers), [Get health check](https://github.com/MewsSystems/poc-open-api-docs/blob/main/pos-api/operations/system.md#get-the-health-check).
  * Sorted all operations alphabetically for better navigation.

## 23rd October 2025

* [Create a payment:](https://github.com/MewsSystems/poc-open-api-docs/blob/main/pos-api/operations/payments.md#create-a-payment)
  * New operation added for creating payments.
* [Idempotency:](https://github.com/MewsSystems/poc-open-api-docs/blob/main/pos-api/guidelines/idempotency.md)
  * New guidelines section added for idempotent API requests.
* [Digital ordering:](/pos-api/use-cases/digital-ordering.md)
  * Enhanced use case documentation.
* [Get orders:](https://github.com/MewsSystems/poc-open-api-docs/blob/main/pos-api/operations/orders.md#get-orders)
  * Major updates to order operations and documentation.
* [Get invoices:](https://github.com/MewsSystems/poc-open-api-docs/blob/main/pos-api/operations/invoices.md#get-invoices)
  * Enhanced invoice operations documentation.
* [Get invoice items:](https://github.com/MewsSystems/poc-open-api-docs/blob/main/pos-api/operations/invoiceitems.md#get-invoice-items)
  * Updated invoice items operations.

## 13th October 2025

* [Webhooks:](/pos-api/events/webhooks.md)
  * Added `order.status.updated` event for order status changes.
  * Added `product.availability.updated` event for product availability changes.
  * Updated field naming from `updated_at` to `updatedAt` for consistency with API conventions.

## 26th September 2025

* [Get payment methods:](https://github.com/MewsSystems/poc-open-api-docs/blob/main/pos-api/operations/paymentmethods.md#get-payment-methods)
  * New operation added.
* [Get product bundles:](https://github.com/MewsSystems/poc-open-api-docs/blob/main/pos-api/operations/productbundles.md#get-product-bundles)
  * New operation added.
* [Get products:](https://github.com/MewsSystems/poc-open-api-docs/blob/main/pos-api/operations/products.md#get-products)
  * Extended [product relationships](https://github.com/MewsSystems/poc-open-api-docs/blob/main/pos-api/operations/products.md#product_relationships) with `taxes`.
* [Get orders:](https://github.com/MewsSystems/poc-open-api-docs/blob/main/pos-api/operations/orders.md#get-orders)
  * Extended [order relationships](https://github.com/MewsSystems/poc-open-api-docs/blob/main/pos-api/operations/orders.md#order_relationships) with `taxes`.
* [Get invoices:](https://github.com/MewsSystems/poc-open-api-docs/blob/main/pos-api/operations/invoices.md#get-invoices)
  * Extended [invoice relationships](https://github.com/MewsSystems/poc-open-api-docs/blob/main/pos-api/operations/invoices.md#invoice_relationships) with `taxes`.
* [Get bookings:](https://github.com/MewsSystems/poc-open-api-docs/blob/main/pos-api/operations/bookings.md#get-bookings)
  * Updated booking status values from "noShow" to "no\_show".
* [Webhooks:](/pos-api/events/webhooks.md)
  * Added `order.status.updated` event for order status changes.
  * Added `product.availability.updated` event for product availability changes.

## 10th September 2025

* [Get promo codes:](https://github.com/MewsSystems/poc-open-api-docs/blob/main/pos-api/operations/promocodes.md#get-promo-codes)
  * New operation added.
* [Get invoices:](https://github.com/MewsSystems/poc-open-api-docs/blob/main/pos-api/operations/invoices.md#get-invoices)
  * Extended [invoice relationships](https://github.com/MewsSystems/poc-open-api-docs/blob/main/pos-api/operations/invoices.md#invoice_relationships) with `promoCode` and `revenueCenter`.
* [Get invoice items:](https://github.com/MewsSystems/poc-open-api-docs/blob/main/pos-api/operations/invoiceitems.md#get-invoice-items)
  * Extended [invoice item relationships](https://github.com/MewsSystems/poc-open-api-docs/blob/main/pos-api/operations/invoiceitems.md#invoice_item_relationships) with `revenueCenter`.
* [Get products:](https://github.com/MewsSystems/poc-open-api-docs/blob/main/pos-api/operations/products.md#get-products)
  * Extended [product attributes](https://github.com/MewsSystems/poc-open-api-docs/blob/main/pos-api/operations/products.md#product_attributes) with `isAvailable`.
  * Extended [product relationships](https://github.com/MewsSystems/poc-open-api-docs/blob/main/pos-api/operations/products.md#product_relationships) with `modifiers`.
* [Get orders:](https://github.com/MewsSystems/poc-open-api-docs/blob/main/pos-api/operations/orders.md#get-orders)
  * Extended [order relationships](https://github.com/MewsSystems/poc-open-api-docs/blob/main/pos-api/operations/orders.md#order_relationships) with `invoice`, `customer`, `booking`, `tables`, and `promoCode`.
* [Get registers:](https://github.com/MewsSystems/poc-open-api-docs/blob/main/pos-api/operations/registers.md#get-registers)
  * Updated operation to return list of registers instead of single register.
* [Get modifier sets:](https://github.com/MewsSystems/poc-open-api-docs/blob/main/pos-api/operations/modifiersets.md#get-modifier-sets)
  * New operation added.
* [Get outlets:](https://github.com/MewsSystems/poc-open-api-docs/blob/main/pos-api/operations/outlets.md#get-outlets)
  * New operation added.
* [Get revenue centers:](https://github.com/MewsSystems/poc-open-api-docs/blob/main/pos-api/operations/revenuecenters.md#get-revenue-centers)
  * New operation added.

## 14th July 2025

* [Get invoices:](https://github.com/MewsSystems/poc-open-api-docs/blob/main/pos-api/operations/invoices.md#get-invoices)
  * Extended [invoice relations](https://github.com/MewsSystems/poc-open-api-docs/blob/main/pos-api/operations/invoices.md#invoice_relationships) with `order`
  * [Update webhook endpoint](https://github.com/MewsSystems/poc-open-api-docs/blob/main/pos-api/operations/webhookendpoints.md#update-webhook-endpoint)
  * Introduced table [filter](https://github.com/MewsSystems/poc-open-api-docs/blob/main/pos-api/operations/tables.md) - `orderIdEq`

## 26th June 2025

* **IMPORTANT!** Changed platform address and API version number from <https://pos.mews.com/api/v2> to <https://api.mews.com/pos/v1>.
* Updated [Environments](/pos-api/guidelines/environments.md) page, including:
  * Production environment platform address
  * Demo environment platform address, API tokens and Mews POS application credentials
  * Demo environment API tokens for linked Mews Operations (PMS) account
  * Environment request limits

## 27th February 2025

* [Get bookings:](https://github.com/MewsSystems/poc-open-api-docs/blob/main/pos-api/operations/bookings.md#get_bookings)
  * Correcting booking JSON example response.
  * Added list of [booking statuses.](https://github.com/MewsSystems/poc-open-api-docs/blob/main/pos-api/operations/bookings.md#booking_attributes)
  * Extended [booking attributes](https://github.com/MewsSystems/poc-open-api-docs/blob/main/pos-api/operations/bookings.md#booking_attributes) with `depositAmount` and `isWalkIn`.
  * Extended bookings [filters](https://github.com/MewsSystems/poc-open-api-docs/blob/main/pos-api/operations/bookings.md#get_bookings) with `bookingDatetimeGt`, `bookingDatetimeGteq`, `bookingDatetimeLt`, `bookingDatetimeLteq`.
* [Create booking:](https://github.com/MewsSystems/poc-open-api-docs/blob/main/pos-api/operations/bookings.md#create_booking)
  * Extended [booking attributes](https://github.com/MewsSystems/poc-open-api-docs/blob/main/pos-api/operations/bookings.md#booking_attributes) with `depositAmount` and `isWalkIn`.
* [Update booking:](https://github.com/MewsSystems/poc-open-api-docs/blob/main/pos-api/operations/bookings.md#update_booking)
  * Extended [booking attributes](https://github.com/MewsSystems/poc-open-api-docs/blob/main/pos-api/operations/bookings.md#booking_attributes) with `depositAmount` and `isWalkIn`.
* [Get products:](https://github.com/MewsSystems/poc-open-api-docs/blob/main/pos-api/operations/products.md#get_products)
  * Added permitted values for [product\_attributes status](https://github.com/MewsSystems/poc-open-api-docs/blob/main/pos-api/operations/products.md#product_attributes) and [modifier\_set\_attributes selection](https://github.com/MewsSystems/poc-open-api-docs/blob/main/pos-api/operations/products.md#product_attributes).
* [Get tables:](https://github.com/MewsSystems/poc-open-api-docs/blob/main/pos-api/operations/tables.md#get_tables)
  * Extended tables relationships, now it is related to `area`.
  * Renamed `number` field to `name`.
* [Create webhook endpoint:](https://github.com/MewsSystems/poc-open-api-docs/blob/main/pos-api/operations/webhookendpoints.md)
  * General improvements to [webhook endpoints page.](https://github.com/MewsSystems/poc-open-api-docs/blob/main/pos-api/operations/webhookendpoints.md) Documentation-only, no changes to API.
* [Get areas:](https://github.com/MewsSystems/poc-open-api-docs/blob/main/pos-api/operations/areas.md)
  * New operation added.
* Added [Table booking](/pos-api/use-cases/table-booking.md) use case.
* Added [Booking status](/pos-api/events/webhooks.md#booking-status) values to [Webhooks](/pos-api/events/webhooks.md).

## 20th February 2025

* Added [API Events](/pos-api/events.md), [Webhooks](/pos-api/events/webhooks.md) and [Webhook security](/pos-api/events/wh-security.md)

## 17th February 2025

* Added new API operation [Create webhook endpoint](https://github.com/MewsSystems/poc-open-api-docs/blob/main/pos-api/operations/webhookendpoints.md#create-webhook-endpoint).
* Corrected booking status in JSON samples in [Bookings](https://github.com/MewsSystems/poc-open-api-docs/blob/main/pos-api/operations/bookings.md).
* Bookings are now connected to [multiple orders](https://github.com/MewsSystems/poc-open-api-docs/blob/main/pos-api/operations/bookings.md#booking_relationships) rather than only one.
* Extended [list of supported filters](/pos-api/guidelines/filtering.md).

## 4th February 2025

* Extended [list of supported filters](/pos-api/guidelines/filtering.md).
* [Get invoices](https://github.com/MewsSystems/poc-open-api-docs/blob/main/pos-api/operations/invoices.md#get-invoices): Extended Filters to include `registerIdEq`.

## 23rd January 2025

* New operations added:
  * [Get bookings](https://github.com/MewsSystems/poc-open-api-docs/blob/main/pos-api/operations/bookings.md#get-bookings)
  * [Create booking](https://github.com/MewsSystems/poc-open-api-docs/blob/main/pos-api/operations/bookings.md#create-booking)
  * [Update booking](https://github.com/MewsSystems/poc-open-api-docs/blob/main/pos-api/operations/bookings.md#update-booking)
  * [Get orders](https://github.com/MewsSystems/poc-open-api-docs/blob/main/pos-api/operations/orders.md#get-orders)
  * [Get customers](https://github.com/MewsSystems/poc-open-api-docs/blob/main/pos-api/operations/customers.md#get-customers)
  * [Create customer](https://github.com/MewsSystems/poc-open-api-docs/blob/main/pos-api/operations/customers.md#create-customer)
  * [Get tables](https://github.com/MewsSystems/poc-open-api-docs/blob/main/pos-api/operations/tables.md#get-tables)
* Updated operations list to match proper inflections.

| Changelog by year                                     |
| ----------------------------------------------------- |
| [Changelog 2024](/pos-api/changelog/changelog2024.md) |


---

# 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/pos-api/changelog.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.