# Deprecations Deprecations are features of the API which you are discouraged from using, even though they may still be supported for a period of time for the sake of backwards compatibility. Such features are normally deprecated because they are superseded by a better alternative. They can include object properties, entire objects or entire API operations. The list of deprecations is as follows. Individual items are also highlighted in the [Changelog](/connector-api/changelog.md) when they occur. Historic deprecations that have already been discontinued may not be listed. **For more information, see our** [**Deprecations Policy**](https://mews-systems.gitbook.io/open-api/staying-up-to-date/deprecations-policy)**.** > **Important:** We strongly advise you to review this list and if you are using any of the deprecated items in your integration, to update your implementation accordingly. The table columns have the following meanings: * **Feature** - What entity or feature is being deprecated * **Comments** - Additional information, such as the reason for the deprecation and what the replacement is * **Deprecated** - The date at which the deprecation notice was given (see the [Changelog](/connector-api/changelog.md)) * **Discontinued** - The date at which it is planned to discontinue the feature completely; a value of '-' indicates no date has been set ## Migration guides * [Migration guide: Restrictions (add/delete to set/clear)](/connector-api/deprecations/migration-guide-restrictions-set-clear.md) * [Migration guide: Get all reservations](/connector-api/deprecations/migration-guide-get-reservations.md) ## Deprecated operations | Feature | Comments | Deprecated | Discontinued | | ----------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------- | ------------ | | [Get all routing rules](/connector-api/operations/routingrules.md#get-all-routing-rules) | Replaced by [Get all billing automations](/connector-api/operations/billingautomations.md#get-all-billing-automations) | 11 Nov 2025 | 10 Jan 2027 | | [Add routing rules](/connector-api/operations/routingrules.md#add-routing-rules) | Replaced by [Add billing automations](/connector-api/operations/billingautomations.md#add-billing-automations) | 11 Nov 2025 | 10 Jan 2027 | | [Update routing rules](/connector-api/operations/routingrules.md#update-routing-rules) | Replaced by [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) | 11 Nov 2025 | 10 Jan 2027 | | [Delete routing rules](/connector-api/operations/routingrules.md#delete-routing-rules) | Replaced by [Delete billing automations](/connector-api/operations/billingautomations.md#delete-billing-automations) | 11 Nov 2025 | 10 Jan 2027 | | [Get customers open items](/connector-api/operations/customers.md#get-customers-open-items) | Replaced by [Get all payments](https://github.com/MewsSystems/open-api-docs/blob/main/connector-api/deprecations/payments.md#get-all-payments) and [Get all order items](https://github.com/MewsSystems/open-api-docs/blob/main/connector-api/deprecations/orderitems.md#get-all-order-items) | 15 Nov 2024 | - | | Add restrictions | Replaced by [Set restrictions](/connector-api/operations/restrictions.md#set-restrictions); see [migration guide](/connector-api/deprecations/migration-guide-restrictions-set-clear.md) | 21 Jun 2024 | 10 Jan 2026 | | Delete restrictions | Replaced by [Clear restrictions](/connector-api/operations/restrictions.md#clear-restrictions); see [migration guide](/connector-api/deprecations/migration-guide-restrictions-set-clear.md) | 21 Jun 2024 | 10 Jan 2026 | |

Get all reservations
(ver 2017-04-12)

| Replaced by [Get all reservations (ver 2023-06-06)](/connector-api/operations/reservations.md#get-all-reservations-ver-2023-06-06); see [Migration guide: Get all reservations](/connector-api/deprecations/migration-guide-get-reservations.md) | 23 Jun 2023 | 10 May 2025 | | [Get all reservation items](/connector-api/operations/reservations.md#get-all-reservation-items) | Replaced by [Get all order items](/connector-api/operations/orderitems.md#get-all-order-items) | 23 Jun 2023 | 10 May 2025 | | [Get all accounting items](/connector-api/operations/accountingitems.md#get-all-accounting-items) | Replaced by [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) | 19 Apr 2023 | 10 Jan 2026 | | [Merge customers](/connector-api/operations/customers.md#merge-customers) | Replaced by [Merge accounts](/connector-api/operations/accounts.md#merge-accounts) | 01 Dec 2022 | 10 May 2025 | | `Get all companies by name` | Replaced by [Get all companies](/connector-api/operations/companies.md#get-all-companies) | 01 Jan 2020 | - | | `Get all bills by Id` | Replaced by [Get all bills](/connector-api/operations/bills.md#get-all-bills) | 01 Jan 2020 | - | | `Get all bills by customer` | Replaced by [Get all bills](/connector-api/operations/bills.md#get-all-bills) | 01 Jan 2020 | - | | `Get all closed bills` | Replaced by [Get all bills](/connector-api/operations/bills.md#get-all-bills) | 01 Jan 2020 | - | | `Get all credit cards by Id` | Replaced by [Get all credit cards](/connector-api/operations/creditcards.md#get-all-credit-cards) | 01 Jan 2020 | - | | `Get all credit cards by customer` | Replaced by [Get all credit cards](/connector-api/operations/creditcards.md#get-all-credit-cards) | 01 Jan 2020 | - | | `Get all reservations by Id` | Replaced by [Get all reservations](/connector-api/operations/reservations.md#get-all-reservations-ver-2017-04-12) | 01 Jan 2020 | - | | `Get all reservations by customer` | Replaced by [Get all reservations](/connector-api/operations/reservations.md#get-all-reservations-ver-2017-04-12) | 01 Jan 2020 | - | | `Get all reservations by numbers` | Replaced by [Get all reservations](/connector-api/operations/reservations.md#get-all-reservations-ver-2017-04-12) | 01 Jan 2020 | - | | `Get all customers by Ids` | Replaced by [Get all customers](/connector-api/operations/customers.md#get-all-customers) | 01 Jan 2020 | - | | `Get all customers by emails` | Replaced by [Get all customers](/connector-api/operations/customers.md#get-all-customers) | 01 Jan 2020 | - | | `Get all customers by name` | Replaced by [Get all customers](/connector-api/operations/customers.md#get-all-customers) | 01 Jan 2020 | - | ## Deprecated properties | Feature | Comments | Deprecated | Discontinued | | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------- | ------------ | | `Blacklist` in [Customer update classifications](/connector-api/operations/accounts.md#customer-update-classifications) and [Customer classifications](/connector-api/operations/accounts.md#customer-classifications) | Replaced by `Blocklist` | 23 Apr 2026 | - | | `Extent` in [Get all services](/connector-api/operations/services.md#get-all-services) | Replaced by `ActivityStates` parameter. | 15 Sep 2025 | | | `Code` in [Get all loyalty memberships](/connector-api/operations/loyaltymemberships.md#get-all-loyalty-memberships), [Add loyalty memberships](/connector-api/operations/loyaltymemberships.md#add-loyalty-memberships), [Update loyalty memberships](/connector-api/operations/loyaltymemberships.md#update-loyalty-memberships) request and response objects. | Replaced by `MembershipNumber` | 05 Aug 2025 | | |

CustomerId, FullName
in Payment terminal command data

| Replaced by `AccountId` and [AccountData](/connector-api/operations/commands.md#account-data-for-payment-terminal-command) | 23 Jan 2025 | 10 Jan 2027 | |

Documents
in Get all customers and Search customers response

| Use [Get all identity documents](/connector-api/operations/identitydocuments.md#get-all-identity-documents) instead | 9th Jan 2025 | 10 Jan 2026 | |

Extent Documents
in Get all customers

| Use [Get all identity documents](/connector-api/operations/identitydocuments.md#get-all-identity-documents) instead | 9th Jan 2025 | 10 Jan 2026 | |

Passport, IdentityCard, Visa, DriversLicense
in Search customers, Get all customers and Get all companionships under extent Customers

| Use [Get all identity documents](/connector-api/operations/identitydocuments.md#get-all-identity-documents) instead | 9th Jan 2025 | 10 Jan 2026 | |

Passport, IdentityCard, Visa, DriversLicense
in Add customer

| Use [Add identity documents](/connector-api/operations/identitydocuments.md#add-identity-documents) instead | 9th Jan 2025 | 10 Jan 2026 | |

Passport, IdentityCard, Visa, DriversLicense
in Update customer

| Use [Update identity documents](/connector-api/operations/identitydocuments.md#update-identity-documents) and [Delete identity documents](/connector-api/operations/identitydocuments.md#delete-identity-documents) instead | 9th Jan 20255 | 10 Jan 2026 | |

Extent ServiceOrders
in Get all availability blocks

| Use [Get all reservations (ver 2023-06-06)](/connector-api/operations/reservations.md#get-all-reservations-ver-2023-06-06) instead | 10 Jan 2025 | 10 Jan 2026 | |

Extent Rates
in Get all availability blocks

| Use [Get all rates](/connector-api/operations/rates.md#get-all-rates) instead | 10 Jan Feb 2025 | 10 Jan 2026 | | `ElectronicInvoiceIdentifier` in [Company](/connector-api/operations/companies.md#company) | Replaced by `AdditionalTaxIdentifier` | 30 Aug 2024 | - | |

Method, RedirectUrl
in Add alternative payment

| Use [Alternative payment method data](/connector-api/operations/payments.md#alternative-payment-method-data) instead | 08 May 2024 | - | |

EndUtc
in Reservations (ver 2023-06-06)

| Replaced by `ScheduledEndUtc` and `ActualEndUtc` | 19 Apr 2024 | - | |

Extent RateGroups
in Get all rates

| Use [Get all rate groups](/connector-api/operations/rategroups.md#get-all-rate-groups) instead | 02 Feb 2024 | 10 Jan 2026 | | `Name` in [Product](/connector-api/operations/products.md#product) | Replaced by `Names` | 12 Dec 2023 | | | `ExternalName` in [Product](/connector-api/operations/products.md#product) | Replaced by `ExternalNames` | 12 Dec 2023 | | | `ShortName` in [Product](/connector-api/operations/products.md#product) | Replaced by `ShortNames` | 12 Dec 2023 | | | `Description` in [Product](/connector-api/operations/products.md#product) | Replaced by `Descriptions` | 12 Dec 2023 | | | `EditableHistoryInterval` in [Get configuration](/connector-api/operations/configuration.md#get-configuration) and [Get all enterprises](/connector-api/operations/enterprises.md#get-all-enterprises) | Replaced by `AccountingEditableHistoryInterval` and `OperationalEditableHistoryInterval` | 05 Dec 2023 | | | `TaxIdentifier` in [Close bill](/connector-api/operations/bills.md#close-bill) | Replaced by `AccountTaxIdentifier` | 21 Nov 2023 | | | `CompanyTaxIdentifier` in [Close bill](/connector-api/operations/bills.md#close-bill) | Replaced by [AssociatedAccountData](/connector-api/operations/bills.md#bill-associated-account-data) | 21 Nov 2023 | | | `Address` in [Close bill](/connector-api/operations/bills.md#close-bill) | Replaced by `AccountAddress` | 21 Nov 2023 | | | `CompanyAddress` in [Close bill](/connector-api/operations/bills.md#close-bill) | Replaced by [AssociatedAccountData](/connector-api/operations/bills.md#bill-associated-account-data) | 21 Nov 2023 | | | `CompanyId` in [Get all bills](/connector-api/operations/bills.md#get-all-bills) | Replaced by `AssociatedAccountIds` | 21 Nov 2023 | | | `CompanyDetails` in [Get all bills](/connector-api/operations/bills.md#get-all-bills) | Replaced by [AssociatedAccountData](/connector-api/operations/bills.md#bill-associated-account-data) | 21 Nov 2023 | | |

Extent ResourceCategoryAssignments
in Get all resources

| Use [Get all resource category assignments](/connector-api/operations/resourcecategories.md#get-all-resource-category-assignments) instead | 01 Nov 2023 | 10 Jan 2025 | |

Extent ResourceCategoryImageAssignments
in Get all resources

| Use [Get all resource category image assignments](/connector-api/operations/resourcecategories.md#get-all-resource-category-image-assignments) instead | 01 Nov 2023 | 10 Jan 2025 | |

Extent ResourceFeatures
in Get all resources

| Use [Get all resource features](/connector-api/operations/resourcefeatures.md#get-all-resource-features) instead | 01 Nov 2023 | 10 Jan 2025 | |

Extent ResourceFeatureAssignments
in Get all resources

| Use [Get all resource feature assignments](/connector-api/operations/resourcefeatures.md#get-all-resource-feature-assignments) instead | 01 Nov 2023 | 10 Jan 2025 | |

Extent VoucherCodes and Companies
in Get all vouchers

| Use [Get all voucher codes](/connector-api/operations/vouchercodes.md#get-all-voucher-codes) and [Get all companies](/connector-api/operations/companies.md#get-all-companies) instead | 23 Oct 2023 | 10 Jan 2025 | |

Extent
in Get all bills

| 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 | 20 Oct 2023 | 10 Jan 2025 | |

StartUtc
in Reservations (ver 2023-06-06)

| Replaced by `ScheduledStartUtc` and `ActualStartUtc` | 06 Sep 2023 | - | |

BillCounters, ProformaCounters, BillPreviewCounters, ServiceOrderCounters, RegistrationCardCounters
in Get all counters

| Replaced by `Counters` | 21 Jun 2023 | | |

CustomerId
in Add external payment

| Replaced by `AccountId` | 24 May 2023 | | |

CustomerId
in Add order

| Replaced by `AccountId` | 24 May 2023 | | | `CustomerId` in [Bill](/connector-api/operations/bills.md#bill) | Replaced by `AccountId` | 24 May 2023 | | |

Extent ResourceCategories
in Get all resources

| Use [Get all resource categories](/connector-api/operations/resourcecategories.md#get-all-resource-categories) instead | 23 May 2023 | 10 Jan 2025 | | `AmountDefault` in [Payment item](/connector-api/operations/accountingitems.md#payment-item) | Replaced by `Original amount` | 11 Apr 2023 | | | `AssigneeData` in [Get all bills](/connector-api/operations/bills.md#get-all-bills) | Replaced by [Owner data](/connector-api/operations/bills.md#bill-owner-data) | 20 Feb 2023 | | |

ItalianFiscalCode, ItalianLotteryCode
in Get all bills

| Retrievable in LegalIdentifiers [Bill customer data](/connector-api/operations/bills.md#bill-customer-data) | 20 Feb 2023 | 10 Jan 2025 | |

Address
in Company

| Replaced by `AddressId` | 18 Jan 2023 | 10 Jan 2025 | |

BasePrices
in Get rate pricing

| Replaced by `BaseAmountPrices` | 18 Jan 2023 | | |

Prices
in Resource category pricing

| Replaced by `AmountPrices` | 18 Jan 2023 | | |

Entities
in General webhook request body

| Fetch data per corresponding [Event discriminator](/connector-api/events/wh-general.md#event-discriminator) | 23 Aug 2022 | - | |

StartUtc, EndUtc
in Availability block, Availability block adjustment

| Replaced by `FirstTimeUnitStartUtc` and `LastTimeUnitStartUtc` | 29 Jun 2022 | - | |

StartUtc, EndUtc
in Availability block parameters, Availability block update parameters

| Replaced by `FirstTimeUnitStartUtc` and `LastTimeUnitStartUtc` | 24 Jun 2022 | - | |

AdultCount, ChildCount
in Reservation, Reservation parameters, Reservation updates

| Replaced by `PersonCounts` and [`Age category`](/connector-api/operations/agecategories.md#age-category) | 11 Feb 2022 | - | |

TimeUnit
in Bookable service data

| Replaced by `TimeUnitPeriod` | 08 Feb 2022 | - | |

DatesUtc
in Get rate pricing

| Replaced by `TimeUnitStartsUtc` | 08 Feb 2022 | - | |

Rebated
in Bill options

| See [Working with rebates](/connector-api/use-cases/accounting.md#working-with-rebates) | 02 Feb 2022 | - | |

CompanionIds
in Reservation

| Replaced by operation [Get all companionships](/connector-api/operations/companionships.md#get-all-companionships) | 03 Mar 2021 | - | |

Gender
in Customer object in Operations using deprecated gender

| Replaced by `Sex` | 29 Sep 2020 | - | |

TimeFilter, StartUtc, EndUtc
in Operations using deprecated time filters

| Replaced by `CreatedUtc`, `UpdatedUtc`, etc. as per operation description | 19 Aug 2020 | - | |

TraveAgencyId
in Reservation

| Replaced by `TravelAgencyId` | 05 Aug 2020 | - | |

CategoryId
in Customer

| - | 02 Jul 2020 | - | |

TimeUnitCost
in Reservation

| Replaced by `TimeUnitPrices` | 17 Jul 2019 | - | |

TaxIdentificationNumber
in Company

| Replaced by `TaxIdentifier` | 25 May 2018 | - | |

ChannelManagerId
in Reservation

| Replaced by `ChannelManagerNumber` | 14 Dec 2016 | - | |

ApplyCancelationFee
in Reservation

| Replaced by `ApplyCancellationFee` | Prior to 2021 | - | |

Total
in Reservation price

| Replaced by `TotalAmount` | Prior to 2021 | - | |

BirthDateUtc
in Customer

| Replaced by `BirthDate` | 07 Jun 2017 | - | |

Passport
in Customer

| Replaced by [Document](/connector-api/operations/customers.md#document) object in `Documents` part of response | Prior to 2021 | - | |

IdentityCard
in Customer

| Replaced by [Document](/connector-api/operations/customers.md#document) object in `Documents` part of response | Prior to 2021 | - | |

Visa
in Customer

| Replaced by [Document](/connector-api/operations/customers.md#document) object in `Documents` part of response | Prior to 2021 | - | |

DriversLicense
in Customer

| Replaced by [Document](/connector-api/operations/customers.md#document) object in `Documents` part of response | Prior to 2021 | - | |

ExpirationUtc
in Document

| Replaced by `Expiration` | 07 Jun 2017 | - | |

IssuanceUtc
in Document

| Replaced by `Issuance` | 07 Jun 2017 | - | |

Net
in Currency value

| - | Prior to 2021 | - | |

Tax
in Currency value

| - | Prior to 2021 | - | |

TaxRate
in Currency value

| - | Prior to 2021 | - | |

Object UnitCost
in Get all accounting items

| Replaced by `Amount` | Prior to 2021 | - | ### Deprecated enum values | Feature | Comments | Deprecated | Discontinued | | ----------------------------------------------------------------------------------------------------------------- | ------------------------------------- | ----------- | ------------ | | `Blacklist` value in [Customer classification](/connector-api/operations/customers.md#customer-classification) | Replaced by `Blocklist`. | 23 Apr 2026 | - | | `CreditCard` value in [External payment type](/connector-api/operations/payments.md#external-payment-type) | Only supported for existing partners. | 14 Jul 2025 | - | | `IDeal` value in [External payment type](/connector-api/operations/payments.md#external-payment-type) | Only supported for existing partners. | 14 Jul 2025 | - | | `PayPal` value in [External payment type](/connector-api/operations/payments.md#external-payment-type) | Only supported for existing partners. | 14 Jul 2025 | - | | `OnlinePayment` value in [External payment type](/connector-api/operations/payments.md#external-payment-type) | Only supported for existing partners. | 14 Jul 2025 | - | | `MasterCard` value in [External payment type](/connector-api/operations/payments.md#external-payment-type) | Only supported for existing partners. | 14 Jul 2025 | - | | `Visa` value in [External payment type](/connector-api/operations/payments.md#external-payment-type) | Only supported for existing partners. | 14 Jul 2025 | - | | `Amex` value in [External payment type](/connector-api/operations/payments.md#external-payment-type) | Only supported for existing partners. | 14 Jul 2025 | - | | `Discover` value in [External payment type](/connector-api/operations/payments.md#external-payment-type) | Only supported for existing partners. | 14 Jul 2025 | - | | `DinersClub` value in [External payment type](/connector-api/operations/payments.md#external-payment-type) | Only supported for existing partners. | 14 Jul 2025 | - | | `Jcb` value in [External payment type](/connector-api/operations/payments.md#external-payment-type) | Only supported for existing partners. | 14 Jul 2025 | - | | `UnionPay` value in [External payment type](/connector-api/operations/payments.md#external-payment-type) | Only supported for existing partners. | 14 Jul 2025 | - | | `DepositCreditCard` value in [External payment type](/connector-api/operations/payments.md#external-payment-type) | Only supported for existing partners. | 3 Apr 2026 | - | ### Operations using deprecated time filters * [Get all customers](/connector-api/operations/customers.md#get-all-customers) * [Get all bills](/connector-api/operations/bills.md#get-all-bills) * [Get all companies](/connector-api/operations/companies.md#get-all-companies) * [Get all restrictions](/connector-api/operations/restrictions.md#get-all-restrictions) * [Get all outlet items](/connector-api/operations/outletitems.md#get-all-outlet-items) * [Get all cashier transactions](/connector-api/operations/cashiertransactions.md#get-all-cashier-transactions) ### Operations using deprecated gender * [Add customer](/connector-api/operations/customers.md#add-customer) * [Update customer](/connector-api/operations/customers.md#update-customer) * [Get all customers](/connector-api/operations/customers.md#get-all-customer) * [Search customers](/connector-api/operations/customers.md#search-customers) * [Get all reservations](/connector-api/operations/reservations.md#get-all-reservations-ver-2017-04-12) ## Deprecated functionality | Feature | Comments | Deprecated | Discontinued | | --------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------- | ----------- | ------------ | | [WebSocket authentication](/connector-api/events/websockets.md#authentication) using URL query parameters | Changed to use cookies instead, which is more secure | 06 Jan 2021 | - | | WebSocket `Space event` | Replaced by [Resource event](/connector-api/events/websockets.md#resource-event) | 21 Sep 2020 | - | --- # 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/deprecations.md?ask= ``` 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.