How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Mews Reservations API

The Reservations API from Mews — 18 operation(s) for reservations.

Mews Reservations API is one of 154 APIs that Mews publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Reservations. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, a getting-started guide, an API reference, a changelog, and a support channel.

This API exposes 18 operations across 18 paths, and defines 146 schemas. It is described by OpenAPI 3.2.0, at version v1.

Requests are made against 2 base URLs: https://api.mews.com, https://api.mews-demo.com.

18 operations 18 paths 146 schemas 18 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
v1
Base URL
https://api.mews.com/api/connector/v1
Authentication
API Key, API Key
Resource Areas
1

Authentication & Security 2

Mews Reservations API declares 2 security schemes for authenticating requests. An API key is passed in the header as ClientToken (MewsClientToken). An API key is passed in the header as AccessToken (MewsAccessToken). By default, every request must be authenticated.

  • MewsClientToken — Mews authentication is performed by supplying ClientToken, AccessToken and Client as fields in the JSON request body (not as HTTP headers). This securityScheme…
  • MewsAccessToken — Tooling-compatible representation of the AccessToken credential, which is supplied in the JSON request body. AccessToken is unique to the connection with a pro…

Paths & Operations 18

Across 18 paths, the API surfaces 18 operations — 18 POST. Each is listed below with its method, path, parameters, and response codes.

Reservations 18
POST
/api/distributor/v1/reservations/getPricing
Mews Get Pricing
reservations_getPricing body → 200
POST
/api/distributor/v1/reservations/price
Mews Price
reservations_price body → 200
POST
/api/connector/v1/reservations/getChannelManagerDetails
Mews Get Reservation Channel Manager Details
reservations_getChannelManagerDetails body → 200400401403408204429500
POST
/api/connector/v1/reservations/getAll/2023-06-06
Mews Get All Reservations (ver 2023-06-06)
reservations_getAll_2023-06-06 body → 200400401403408204429500
POST
/api/connector/v1/reservations/getAlldeprecated
Mews Get All Reservations (ver 2017-04-12)
reservations_getAll body → 200400401403408204429500
POST
/api/connector/v1/reservations/add
Mews Add Reservations
reservations_add body → 200400401403408204429500
POST
/api/connector/v1/reservations/update
Mews Update Reservations
reservations_update body → 200400401403408204429500
POST
/api/connector/v1/reservations/confirm
Mews Confirm Reservation
reservations_confirm body → 200400401403408204429500
POST
/api/connector/v1/reservations/start
Mews Start Reservation
reservations_start body → 200400401403408204429500
POST
/api/connector/v1/reservations/process
Mews Process Reservation
reservations_process body → 200400401403408204429500
POST
/api/connector/v1/reservations/cancel
Mews Cancel Reservation
reservations_cancel body → 200400401403408204429500
POST
/api/connector/v1/reservations/updateCustomer
Mews Update Reservation Customer
reservations_updateCustomer body → 200400401403408204429500
POST
/api/connector/v1/reservations/updateInterval
Mews Update Reservation Interval
reservations_updateInterval body → 200400401403408204429500
POST
/api/connector/v1/reservations/addCompanion
Mews Add Reservation Companion
reservations_addCompanion body → 200400401403408204429500
POST
/api/connector/v1/reservations/deleteCompanion
Mews Delete Reservation Companion
reservations_deleteCompanion body → 200400401403408204429500
POST
/api/connector/v1/reservations/addProduct
Mews Add Reservation Product
reservations_addProduct body → 200400401403408204429500
POST
/api/connector/v1/reservations/getAllItemsdeprecated
Mews Get All Reservation Items
reservations_getAllItems body → 200400401403408204429500
POST
/api/connector/v1/reservations/price
Mews Price Reservations
reservations_price body → 200400401403408204429500

Schemas 146

The contract defines 146 schemas that model the data the API accepts and returns. The most detailed are Customer (46 properties), ReservationOld (40 properties), Reservation_2 (40 properties), Company (32 properties). Each schema is shown below with its type and property counts.

ReservationAdditionParameters
object
11 properties 5 required
RateGroupOld
object
5 properties
Amount
object
5 properties 5 required
SexEnum
string
Male Female
CreditRating
object
Credit rating to define creditworthiness of the company.
1 property
ReservationPricingInfo
object
5 properties 2 required
ProductOrderPricingInfo
object
6 properties 5 required
ReservationExtent
object
Extent of data to be returned. E.g. it is possible to specify that together with the reservations, customers, groups and rates should be also returned.
18 properties
ExtendedAmount
object
9 properties 5 required
SettlementRuleTrigger
string
CustomerClassificationEnum
string
PaymasterAccount Blacklist (Deprecated, use Blocklist instead.) Media LoyaltyProgram PreviousComplaint Returning Staff FriendOrFamily TopManagement Important V…
ReservationPricingResult
object
1 property 1 required
Amount_2
object
5 properties 5 required
AddProductItemsResult
object
1 property
OrderItemOld
object
20 properties 13 required
ReservationsChannelManagerDetailsFilterParameters
object
4 properties 4 required
ResourceCategory
object
14 properties 12 required
ReservationUpdateParameters
object
23 properties 4 required
ReservationCancellationParameters
object
9 properties 4 required
RebateOrderItemData
object
1 property 1 required
Service
object
15 properties 10 required
ReservationData
object
25 properties 6 required
ReservationProductParameters
object
9 properties 6 required
Occupancy
object
3 properties
Limitation
object
Limitation on the quantity of data returned.
2 properties 1 required
ProductOrderItemData
object
2 properties 1 required
ReservationsChannelManagerDetailsResult
object
1 property 1 required
ReservationOldOrigin
string
CancellationReason
string
ResourceOccupancyPricing
object
4 properties 1 required
ReservationSettlement
object
6 properties 6 required
SpaceData
object
2 properties 1 required
ReservationServiceOrderFilterParameters
object
23 properties 4 required
PerUnitPriceParameters
object
2 properties
ReservationServiceOrderResult
object
2 properties 1 required
CustomerOptionsEnum
string
None SendMarketingEmails Invoiceable BillAddressObjection SendMarketingPostalMail SendPartnerMarketingEmails SendPartnerMarketingPostalMail WithdrawCardConsent…
ResourcePricing
object
3 properties 3 required
TaxBreakdown_2
object
1 property 1 required
MultipleReservationResult
object
1 property 1 required
AccountingItem
object
20 properties
ServiceOrderStateOld
string
ReservationPurpose
string
ReservationPriceResult
object
1 property 1 required
AccountingState
string
ReservationProcessingParameters
object
8 properties 4 required
ProductOrderAdditionData
object
6 properties 1 required
ProductClassifications
object
5 properties
Customer
object
46 properties 12 required
ProductOptions
object
5 properties 5 required
ServiceDataDiscriminator
string
ReservationResult
object
18 properties
ReservationOld
object
40 properties 18 required
AdditionalServiceData
object
1 property 1 required
TaxBreakdownItem_2
object
3 properties 2 required
ReservationPurposeEnum
string
Leisure Business Student
ReservationUpdateOptionsParameters
object
1 property
BooleanUpdateValue
object
1 property
ReservationPricingParameters
object
14 properties 7 required
Reservation_2
object
40 properties 20 required
ReservationPersonCount
object
2 properties 2 required
TaxValue
object
2 properties 2 required
RelativeProductPrice
object
4 properties
ResourceDataDiscriminator
string
Whether the resource is space, object, or person.
CurrencyValueOld
object
Total price of the reservation.
5 properties 1 required
ReservationItemResult
object
1 property 1 required
ReservationPriceParameters
object
8 properties 4 required
ServiceOrderOriginEnum
string
Distributor (From the Mews Booking Engine or Booking Engine API.) ChannelManager (From a channel manager.) Commander (From Mews Operations.) Import (From an im…
ResourceAccessToken
object
14 properties 11 required
ResourceFeatureClassification
string
Classification of ResourceFeature.
TaxExemptionReasonTypeEnum
string
Unknown (Unknown tax exemption reason) ITN1 (N1 - Escluse ex art.15) ITN22 (N2.2 - Non soggette – altri casi) ITN35 (N3.5 - Non imponibili – a seguito di dichi…
ReservationItems
object
3 properties 2 required
CompanyOptions
object
Options of the company.
3 properties
ReservationUpdatePerUnitPriceParameters
object
1 property
OrderNote
object
6 properties
ResourceAccessTokenType
string
Type of stored value.
ReservationPrice
object
3 properties 1 required
ResourceClassification
string
Classification of the resource category.
Reservation
object
17 properties 9 required
ResourceState
string
State of the resource. Dirty Clean Inspected OutOfService OutOfOrder
CompanionshipAddParameters
object
6 properties 5 required
OldAddress
object
9 properties
Title
string
Type of the title prefix of the customer. Note that the value should not be used as-is, but localized. For example, the value Misses should be displayed as Mrs…
ReservationTimeFilter
string
ReservationOptions
object
3 properties 3 required
GuidUpdateValue
object
1 property
RateForExtent
object
Rate entity, without some of the details, e.g. pricing.
17 properties 10 required
Rate
object
7 properties 7 required
Company
object
32 properties 7 required
ReservationQrCodeData
object
2 properties
MultipleReservationUpdateParameters
object
27 properties 5 required
ProductOptions_2
object
2 properties 2 required
ServiceOrderStateEnum
string
Inquired (Confirmed neither by the customer nor enterprise.) Confirmed (Confirmed by both parties, before check-in.) Started (Checked in.) Processed (Checked o…
ResourceAccessTokenPermissions
object
4 properties
AddedReservation
object
2 properties 1 required
RateTypeEnum
string
Public Private AvailabilityBlock
Unit
object
ReservationStartParameters
object
5 properties 4 required
TaxValue_2
object
2 properties 1 required
Resource
object
12 properties 11 required
TimeUnitPeriodEnum
string
Day Month Hour
OrderItemTypeOld
string
StringUpdateValue
object
1 property
ProductChargingMode
string
Promotions
object
6 properties 6 required
ServiceOptions
object
Options of the service.
1 property 1 required
ReservationDataParameters
object
5 properties 5 required
BookableServiceData
object
6 properties 6 required
ReservationGroupOld
object
2 properties
TimeFilterInterval
object
When a time interval is used for filtering (for example in parameters such as CreatedUtc.StartUtc / CreatedUtc.EndUtc), the following rules apply: - Start equa…
2 properties
ServiceOrderOptions
object
4 properties 4 required
ReservationUpdateIntervalParameters
object
8 properties 5 required
ConfirmReservationParameters
object
6 properties 4 required
AmountParameters
object
Price of the product that overrides the price defined in Mews.
4 properties 2 required
ProductChargingModeEnum
string
Once PerTimeUnit PerPersonPerTimeUnit PerPerson
TaxBreakdownItem
object
3 properties 2 required
ReservationUpdatePersonCountParameters
object
1 property
IdentityDocument
object
10 properties
Product
object
31 properties 17 required
ChannelManagerDetails
object
7 properties 3 required
ServiceOrderCancellationReasonEnum
string
Other ConfirmationMissed BookedElsewhere ForceMajeure GuestComplaint NoShow PriceTooHigh ServiceNotAvailable InputError InvalidPayment TravelAgency RequestedBy…
ReservationItemParameters
object
6 properties 4 required
OrderNoteTypeEnum
string
General ChannelManager SpecialRequest
ReservationAdditionResult
object
1 property 1 required
ResourcePrice
object
6 properties 4 required
TaxBreakdown
object
1 property 1 required
ProductConsumptionMomentEnum
string
ServiceOrderEnd ServiceOrderStart PostingTimeUnit NextTimeUnit
ReservationsUpdateCustomerParameters
object
6 properties 5 required
ProductPostingModeEnum
string
Once PerTimeUnit
ProductPostingEnum
string
Once Daily
SettlementRuleType
string
CompanionshipAddResult
object
1 property 1 required
ProductPricing
string
SettlementRuleAction
string
ReservationPricing
object
1 property 1 required
ReservationFilterParameters
object
20 properties 6 required
IdentityDocumentTypeEnum
string
IdentityCard Passport Visa DriversLicense
CompanionshipDeleteParameters
object
6 properties 5 required
GuidNullableUpdateValue
object
1 property
CreditRatingBasicEnum
string
CreditOk (Company can book services.) PaymentRequiredUpfront (Company must pay upfront.) LocalDecisionRequired (Requires local approval.)
OccupancyData
object
2 properties 2 required
AccountType
string
A discriminator specifying the account type, e.g. Customer or Company
ConnectorApiExceptionResult
object
3 properties
ResourceCategoryType
string
Type of the category.
BusinessSegment
object
6 properties 6 required
ResourceCategoryAssignment
object
6 properties 6 required
ServiceOrderCommanderOriginEnum
string
InPerson Channel Phone Email Website Message CallCenter RoomingList

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

mews-systems-reservations-api-openapi.yml Raw ↑

Other APIs Mews publishes across the network.

Mews Channel Manager API
Mews POS API
Mews Loyalty Partner API
Mews Account notes API
Mews Accounting categories API
Mews Accounting items API
Mews Accounts API
Mews Addresses API
Mews Age categories API
Mews Availability adjustments API
Mews Availability Blocks API
Mews Billing automations API
Where this information came from

This is an independent, third-party profile of Mews Reservations API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.