Skip to content
Mews Open API

Deprecations

Deprecations

Section titled “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 when they occur. Historic deprecations that have already been discontinued may not be listed.

For more information, see our 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)
  • Discontinued - The date at which it is planned to discontinue the feature completely; a value of ’-’ indicates no date has been set

Migration guides

Section titled “Migration guides”

Deprecated operations

Section titled “Deprecated operations”
FeatureCommentsDeprecatedDiscontinued
Get customers open itemsReplaced by Get all payments and Get all order items15 Nov 2024-
Add restrictionsReplaced by Set restrictions21 Jun 202410 Jan 2026
Delete restrictionsReplaced by Clear restrictions21 Jun 202410 Jan 2026
Get all reservations
(ver 2017-04-12)		Replaced by Get all reservations (ver 2023-06-06); see Migration guide: Get all reservations23 Jun 202310 May 2025
Get all reservation itemsReplaced by Get all order items23 Jun 202310 May 2025
Get all accounting itemsReplaced by Get all payments and Get all order items19 Apr 202310 Jan 2026
Merge customersReplaced by Merge accounts01 Dec 202210 May 2025
Get all companies by nameReplaced by Get all companies01 Jan 2020-
Get all bills by IdReplaced by Get all bills01 Jan 2020-
Get all bills by customerReplaced by Get all bills01 Jan 2020-
Get all closed billsReplaced by Get all bills01 Jan 2020-
Get all credit cards by IdReplaced by Get all credit cards01 Jan 2020-
Get all credit cards by customerReplaced by Get all credit cards01 Jan 2020-
Get all reservations by IdReplaced by Get all reservations01 Jan 2020-
Get all reservations by customerReplaced by Get all reservations01 Jan 2020-
Get all reservations by numbersReplaced by Get all reservations01 Jan 2020-
Get all customers by IdsReplaced by Get all customers01 Jan 2020-
Get all customers by emailsReplaced by Get all customers01 Jan 2020-
Get all customers by nameReplaced by Get all customers01 Jan 2020-

Deprecated properties

Section titled “Deprecated properties”
FeatureCommentsDeprecatedDiscontinued
CustomerId, FullName
in Payment terminal command data		Replaced by AccountId and AccountData23 Jan 202510 Jan 2027
Documents
in Get all customers and Search customers response		Use Get all identity documents instead9th Jan 202510 Jan 2026
Extent Documents
in Get all customers		Use Get all identity documents instead9th Jan 202510 Jan 2026
Passport, IdentityCard, Visa, DriversLicense
in Search customers, Get all customers and Get all companionships under extent Customers		Use Get all identity documents instead9th Jan 202510 Jan 2026
Passport, IdentityCard, Visa, DriversLicense
in Add customer		Use Add identity documents instead9th Jan 202510 Jan 2026
Passport, IdentityCard, Visa, DriversLicense
in Update customer		Use Update identity documents and Delete identity documents instead9th Jan 2025510 Jan 2026
Extent ServiceOrders
in Get all availability blocks		Use Get all reservations (ver 2023-06-06) instead10 Jan 202510 Jan 2026
Extent Rates
in Get all availability blocks		Use Get all rates instead10 Jan Feb 202510 Jan 2026
ElectronicInvoiceIdentifier in CompanyReplaced by AdditionalTaxIdentifier30 Aug 2024-
Method, RedirectUrl
in Add alternative payment		Use Alternative payment method data instead08 May 2024-
EndUtc
in Reservations (ver 2023-06-06)		Replaced by ScheduledEndUtc and ActualEndUtc19 Apr 2024-
Extent RateGroups
in Get all rates		Use Get all rate groups instead02 Feb 202410 Jan 2026
Name in ProductReplaced by Names12 Dec 2023
ExternalName in ProductReplaced by ExternalNames12 Dec 2023
ShortName in ProductReplaced by ShortNames12 Dec 2023
Description in ProductReplaced by Descriptions12 Dec 2023
EditableHistoryInterval in Get configuration and Get all enterprisesReplaced by AccountingEditableHistoryInterval and OperationalEditableHistoryInterval05 Dec 2023
TaxIdentifier in Close billReplaced by AccountTaxIdentifier21 Nov 2023
CompanyTaxIdentifier in Close billReplaced by AssociatedAccountData21 Nov 2023
Address in Close billReplaced by AccountAddress21 Nov 2023
CompanyAddress in Close billReplaced by AssociatedAccountData21 Nov 2023
CompanyId in Get all billsReplaced by AssociatedAccountIds21 Nov 2023
CompanyDetails in Get all billsReplaced by AssociatedAccountData21 Nov 2023
Extent ResourceCategoryAssignments
in Get all resources		Use Get all resource category assignments instead01 Nov 202310 Jan 2025
Extent ResourceCategoryImageAssignments
in Get all resources		Use Get all resource category image assignments instead01 Nov 202310 Jan 2025
Extent ResourceFeatures
in Get all resources		Use Get all resource features instead01 Nov 202310 Jan 2025
Extent ResourceFeatureAssignments
in Get all resources		Use Get all resource feature assignments instead01 Nov 202310 Jan 2025
Extent VoucherCodes and Companies
in Get all vouchers		Use Get all voucher codes and Get all companies instead23 Oct 202310 Jan 2025
Extent
in Get all bills		Use Get all payments and Get all order items instead20 Oct 202310 Jan 2025
StartUtc
in Reservations (ver 2023-06-06)		Replaced by ScheduledStartUtc and ActualStartUtc06 Sep 2023-
BillCounters, ProformaCounters, BillPreviewCounters, ServiceOrderCounters, RegistrationCardCounters
in Get all counters		Replaced by Counters21 Jun 2023
CustomerId
in Add external payment		Replaced by AccountId24 May 2023
CustomerId
in Add order		Replaced by AccountId24 May 2023
CustomerId in BillReplaced by AccountId24 May 2023
Extent ResourceCategories
in Get all resources		Use Get all resource categories instead23 May 202310 Jan 2025
AmountDefault in Payment itemReplaced by Original amount11 Apr 2023
AssigneeData in Get all bills Replaced by Owner data20 Feb 2023
ItalianFiscalCode, ItalianLotteryCode
in Get all bills		Retrievable in LegalIdentifiers Bill customer data20 Feb 202310 Jan 2025
Address
in Company		Replaced by AddressId18 Jan 202310 Jan 2025
BasePrices
in Get rate pricing		Replaced by BaseAmountPrices18 Jan 2023
Prices
in Resource category pricing		Replaced by AmountPrices18 Jan 2023
Entities
in General webhook request body		Fetch data per corresponding Event discriminator23 Aug 2022-
StartUtc, EndUtc
in Availability block, Availability block adjustment		Replaced by FirstTimeUnitStartUtc and LastTimeUnitStartUtc29 Jun 2022-
StartUtc, EndUtc
in Availability block parameters, Availability block update parameters		Replaced by FirstTimeUnitStartUtc and LastTimeUnitStartUtc24 Jun 2022-
AdultCount, ChildCount
in Reservation, Reservation parameters, Reservation updates		Replaced by PersonCounts and Age category11 Feb 2022-
TimeUnit
in Bookable service data		Replaced by TimeUnitPeriod08 Feb 2022-
DatesUtc
in Get rate pricing		Replaced by TimeUnitStartsUtc08 Feb 2022-
Rebated
in Bill options		See Working with rebates02 Feb 2022-
CompanionIds
in Reservation		Replaced by operation Get all companionships03 Mar 2021-
Gender
in Customer object in Operations using deprecated gender		Replaced by Sex29 Sep 2020-
TimeFilter, StartUtc, EndUtc
in Operations using deprecated time filters		Replaced by CreatedUtc, UpdatedUtc, etc. as per operation description19 Aug 2020-
TraveAgencyId
in Reservation		Replaced by TravelAgencyId05 Aug 2020-
CategoryId
in Customer		-02 Jul 2020-
TimeUnitCost
in Reservation		Replaced by TimeUnitPrices17 Jul 2019-
TaxIdentificationNumber
in Company		Replaced by TaxIdentifier25 May 2018-
ChannelManagerId
in Reservation		Replaced by ChannelManagerNumber14 Dec 2016-
ApplyCancelationFee
in Reservation		Replaced by ApplyCancellationFeePrior to 2021-
Total
in Reservation price		Replaced by TotalAmountPrior to 2021-
BirthDateUtc
in Customer		Replaced by BirthDate07 Jun 2017-
Passport
in Customer		Replaced by Document object in Documents part of responsePrior to 2021-
IdentityCard
in Customer		Replaced by Document object in Documents part of responsePrior to 2021-
Visa
in Customer		Replaced by Document object in Documents part of responsePrior to 2021-
DriversLicense
in Customer		Replaced by Document object in Documents part of responsePrior to 2021-
ExpirationUtc
in Document		Replaced by Expiration07 Jun 2017-
IssuanceUtc
in Document		Replaced by Issuance07 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 AmountPrior to 2021-

Operations using deprecated time filters

Section titled “Operations using deprecated time filters”

Operations using deprecated gender

Section titled “Operations using deprecated gender”

Deprecated functionality

Section titled “Deprecated functionality”
FeatureCommentsDeprecatedDiscontinued
WebSocket authentication using URL query parametersChanged to use cookies instead, which is more secure06 Jan 2021-
WebSocket Space eventReplaced by Resource event21 Sep 2020-