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 — 16 operation(s) for reservations.

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

This API exposes 2 JSON Schema definitions.

Tagged areas include Reservations. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, a JSON-LD context, and 2 JSON Schemas.

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

Requests are made against a single base URL, https://api.mews.com.

16 operations 16 paths 123 schemas 16 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
Resource Areas
1

Paths & Operations 16

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

Reservations 16
POST
/api/connector/v1/reservations/getChannelManagerDetails
Get reservation channel manager details
reservations_getChannelManagerDetails body → 200400401403408204429500
POST
/api/connector/v1/reservations/getAll/2023-06-06
Get all reservations (ver 2023-06-06)
reservations_getAll_2023-06-06 body → 200400401403408204429500
POST
/api/connector/v1/reservations/getAlldeprecated
Get all reservations (ver 2017-04-12)
reservations_getAll body → 200400401403408204429500
POST
/api/connector/v1/reservations/price
Price reservations
reservations_price body → 200400401403408204429500
POST
/api/connector/v1/reservations/add
Add reservations
reservations_add body → 200400401403408204429500
POST
/api/connector/v1/reservations/update
Update reservations
reservations_update body → 200400401403408204429500
POST
/api/connector/v1/reservations/confirm
Confirm reservation
reservations_confirm body → 200400401403408204429500
POST
/api/connector/v1/reservations/start
Start reservation
reservations_start body → 200400401403408204429500
POST
/api/connector/v1/reservations/process
Process reservation
reservations_process body → 200400401403408204429500
POST
/api/connector/v1/reservations/cancel
Cancel reservation
reservations_cancel body → 200400401403408204429500
POST
/api/connector/v1/reservations/updateCustomer
Update reservation customer
reservations_updateCustomer body → 200400401403408204429500
POST
/api/connector/v1/reservations/updateInterval
Update reservation interval
reservations_updateInterval body → 200400401403408204429500
POST
/api/connector/v1/reservations/addCompanion
Add reservation companion
reservations_addCompanion body → 200400401403408204429500
POST
/api/connector/v1/reservations/deleteCompanion
Delete reservation companion
reservations_deleteCompanion body → 200400401403408204429500
POST
/api/connector/v1/reservations/addProduct
Add reservation product
reservations_addProduct body → 200400401403408204429500
POST
/api/connector/v1/reservations/getAllItemsdeprecated
Get all reservation items
reservations_getAllItems body → 200400401403408204429500

Schemas 123

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

ServiceOrderOptions
object
4 properties 4 required
CompanionshipAddResult
object
1 property 1 required
ServiceDataDiscriminator
string
ConfirmReservationParameters
object
6 properties 4 required
AccountingItem
object
20 properties
OrderNoteTypeEnum
string
General ChannelManager SpecialRequest
ReservationOptions
object
3 properties 3 required
PerUnitPriceParameters
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
ReservationProcessingParameters
object
8 properties 4 required
ReservationPricingResult
object
1 property 1 required
CustomerClassificationEnum
string
PaymasterAccount Blacklist (Deprecated, use Blocklist instead.) Media LoyaltyProgram PreviousComplaint Returning Staff FriendOrFamily TopManagement Important V…
BooleanUpdateValue
object
1 property
ReservationServiceOrderFilterParameters
object
23 properties 4 required
MultipleReservationUpdateParameters
object
27 properties 5 required
RateTypeEnum
string
Public Private AvailabilityBlock
BookableServiceData
object
6 properties 6 required
CustomerOptionsEnum
string
None SendMarketingEmails Invoiceable BillAddressObjection SendMarketingPostalMail SendPartnerMarketingEmails SendPartnerMarketingPostalMail WithdrawCardConsent…
ReservationUpdateOptionsParameters
object
1 property
AmountParameters
object
Price of the product that overrides the price defined in Mews.
4 properties 2 required
TaxValue
object
2 properties 1 required
GuidUpdateValue
object
1 property
SexEnum
string
Male Female
ResourceAccessToken
object
14 properties 11 required
ReservationDataParameters
object
5 properties 5 required
OldAddress
object
9 properties
CompanionshipAddParameters
object
6 properties 5 required
ConnectorApiExceptionResult
object
3 properties
ResourceClassification
string
Classification of the resource category.
ReservationOld
object
40 properties 18 required
OrderItemTypeOld
string
AdditionalServiceData
object
1 property 1 required
Company
object
32 properties 7 required
CancellationReason
string
ReservationGroupOld
object
2 properties
ReservationUpdatePerUnitPriceParameters
object
1 property
IdentityDocumentTypeEnum
string
IdentityCard Passport Visa DriversLicense
ProductOrderAdditionData
object
6 properties 1 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
TimeUnitPeriodEnum
string
Day Month Hour
Reservation
object
40 properties 20 required
ReservationPrice
object
3 properties 1 required
ReservationServiceOrderResult
object
2 properties 1 required
RebateOrderItemData
object
1 property 1 required
ReservationUpdatePersonCountParameters
object
1 property
ExtendedAmount
object
9 properties 5 required
ProductPostingEnum
string
Once Daily
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…
Resource
object
12 properties 11 required
ResourceDataDiscriminator
string
Whether the resource is space, object, or person.
AddedReservation
object
2 properties 1 required
Service
object
15 properties 10 required
ReservationsChannelManagerDetailsFilterParameters
object
4 properties 4 required
ProductClassifications
object
5 properties
TaxBreakdownItem
object
3 properties 2 required
ReservationTimeFilter
string
RelativeProductPrice
object
4 properties
ReservationFilterParameters
object
20 properties 6 required
ProductPricing
string
ServiceOrderStateOld
string
RateForExtent
object
Rate entity, without some of the details, e.g. pricing.
17 properties 10 required
ReservationUpdateParameters
object
23 properties 4 required
OrderNote
object
6 properties
ReservationItemResult
object
1 property 1 required
AccountingState
string
ProductOrderItemData
object
2 properties 1 required
ResourceAccessTokenPermissions
object
4 properties
ServiceOptions
object
Options of the service.
1 property 1 required
ReservationCancellationParameters
object
9 properties 4 required
CompanionshipDeleteParameters
object
6 properties 5 required
GuidNullableUpdateValue
object
1 property
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…
ReservationsUpdateCustomerParameters
object
6 properties 5 required
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…
ResourceState
string
State of the resource. Dirty Clean Inspected OutOfService OutOfOrder
CreditRating
object
Credit rating to define creditworthiness of the company.
1 property
ReservationData
object
25 properties 6 required
ReservationPersonCount
object
2 properties 2 required
BusinessSegment
object
6 properties 6 required
ReservationQrCodeData
object
2 properties
ReservationsChannelManagerDetailsResult
object
1 property 1 required
RateGroupOld
object
5 properties
Customer
object
46 properties 12 required
ProductConsumptionMomentEnum
string
ServiceOrderEnd ServiceOrderStart PostingTimeUnit NextTimeUnit
ReservationItemParameters
object
6 properties 4 required
ServiceOrderCommanderOriginEnum
string
InPerson Channel Phone Email Website Message CallCenter RoomingList
Limitation
object
Limitation on the quantity of data returned.
2 properties 1 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…
MultipleReservationResult
object
1 property 1 required
ReservationProductParameters
object
9 properties 6 required
IdentityDocument
object
10 properties
ProductPostingModeEnum
string
Once PerTimeUnit
Unit
object
ResourceCategoryAssignment
object
6 properties 6 required
CompanyOptions
object
Options of the company.
3 properties
ServiceOrderCancellationReasonEnum
string
Other ConfirmationMissed BookedElsewhere ForceMajeure GuestComplaint NoShow PriceTooHigh ServiceNotAvailable InputError InvalidPayment TravelAgency RequestedBy…
ReservationAdditionResult
object
1 property 1 required
OrderItemOld
object
20 properties 13 required
SpaceData
object
2 properties 1 required
ChannelManagerDetails
object
7 properties 3 required
ReservationStartParameters
object
5 properties 4 required
ReservationAdditionParameters
object
11 properties 5 required
ReservationUpdateIntervalParameters
object
8 properties 5 required
StringUpdateValue
object
1 property
ResourceCategory
object
14 properties 12 required
ReservationResult
object
18 properties
ResourceAccessTokenType
string
Type of stored value.
AddProductItemsResult
object
1 property
Amount
object
5 properties 5 required
CreditRatingBasicEnum
string
CreditOk (Company can book services.) PaymentRequiredUpfront (Company must pay upfront.) LocalDecisionRequired (Requires local approval.)
TaxBreakdown
object
1 property 1 required
ReservationPurpose
string
ProductOptions
object
1 property 1 required
ReservationItems
object
3 properties 2 required
ResourceCategoryType
string
Type of the category.
ReservationOldOrigin
string
CurrencyValueOld
object
Total price of the reservation.
5 properties 1 required
ReservationPurposeEnum
string
Leisure Business Student
AccountType
string
A discriminator specifying the account type, e.g. Customer or Company
ProductChargingModeEnum
string
Once PerTimeUnit PerPersonPerTimeUnit PerPerson
Product
object
31 properties 17 required
Promotions
object
6 properties 6 required
ResourceFeatureClassification
string
Classification of ResourceFeature.

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

mews-com-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.