Mews

Mews Reservations API

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

GitHub OpenAPI

Documentation

📖
Documentation
https://docs.mews.com/connector-api

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/mews/refs/heads/main/openapi/mews-reservations-api-openapi.yml

Other Resources

🔗
OpenAPI Source
https://api.mews.com/Swagger/connector/swagger.yaml

OpenAPI Specification

mews-reservations-api-openapi.yml Raw ↑ 
openapi: 3.0.4
info:
  title: Connector Account notes Reservations API
  description: General-purpose API that enables partners of Mews to access data and services in Mews Operations
  termsOfService: https://www.mews.com/en/terms-conditions/partners
  contact:
    name: Partner success
    email: partnersuccess@mews.com
  version: v1
servers:
- url: https://api.mews.com
tags:
- name: Reservations
paths:
  /api/connector/v1/reservations/getChannelManagerDetails:
    post:
      tags:
      - Reservations
      summary: Get reservation channel manager details
      description: Returns channel manager-related details for the specified reservations. Note this operation supports [Portfolio Access Tokens](https://mews-systems.gitbook.io/connector-api/concepts/multi-property/).
      operationId: reservations_getChannelManagerDetails
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ReservationsChannelManagerDetailsFilterParameters'
            example:
              ClientToken: E0D439EE522F44368DC78E1BFB03710C-D24FB11DBE31D4621C4817E028D9E1D
              AccessToken: C66EF7B239D24632943D115EDE9CB810-EA00F8FD8294692C940F6B5A8F9453D
              Client: Sample Client 1.0.0
              ReservationIds:
              - 9b59b50d-bd32-4ce5-add8-09ea0e1300e7
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ReservationsChannelManagerDetailsResult'
              example:
                ChannelManagerDetails:
                - ReservationId: 3fa85f64-5717-4562-b3fc-2c963f66afa6
                  RequestedRateCode: XyZ123AbC789
                  ChannelManagerName: HotelConnect
                  ChannelNumber: HC1234
                  ChannelManagerGroupNumber: 9E5F7BC3B6F0102
                  ChannelManagerNumber: '1'
                  CreatedUtc: '2025-03-10T15:30:00Z'
                - ReservationId: 9b59b50d-bd32-4ce5-add8-09ea0e1300e7
                  RequestedRateCode: LmN456OpQ012
                  ChannelManagerName: GlobalRes
                  ChannelNumber: GR5678
                  ChannelManagerGroupNumber: 461190401CD25FE
                  ChannelManagerNumber: '1'
                  CreatedUtc: '2025-03-11T09:45:00Z'
        '400':
          description: Error caused by the client app, e.g. in case of malformed request or invalid identifier of a resource. In most cases, such an error signifies a bug in the client app (consumer of the API).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectorApiExceptionResult'
        '401':
          description: Error caused by usage of invalid ClientToken, AccessToken, or you may not have the necessary permission to use the endpoint.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectorApiExceptionResult'
        '403':
          description: Server error that should be reported to the end user of the client app. Happens for example when the server-side validation fails or when a business-logic check is violated.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectorApiExceptionResult'
        '408':
          description: Error caused by heavy request that takes too long to process (typically tens of seconds). To get around this, request data in smaller batches. For more information, see [Request timeouts](https://mews-systems.gitbook.io/connector-api/guidelines/requests#request-timeouts)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectorApiExceptionResult'
        '204':
          description: Server has successfully fulfilled the request and there is no additional information to send back.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectorApiExceptionResult'
        '429':
          description: Error caused by too many requests sent in a given amount of time. Response contains `Retry-After` header indicating how long the user agent should wait before making a follow-up request. For more information, see [Request limits](https://mews-systems.gitbook.io/connector-api/guidelines/requests#request-limits).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectorApiExceptionResult'
        '500':
          description: Unexpected error on the Mews side. This may be due to a software fault. If such a situation occurs, the error will be logged and the development team notified, however you can raise an issue through GitHub on our [documentation repository](https://github.com/MewsSystems/gitbook-connector-api).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectorApiExceptionResult'
      x-restricted: true
  /api/connector/v1/reservations/getAll/2023-06-06:
    post:
      tags:
      - Reservations
      summary: Get all reservations (ver 2023-06-06)
      description: 'Returns all reservations within scope of the Access Token, filtered according to the specified parameters. This operation uses [Pagination](https://mews-systems.gitbook.io/connector-api/guidelines/pagination) and supports [Portfolio Access Tokens](https://mews-systems.gitbook.io/connector-api/concepts/multi-property).

        '
      operationId: reservations_getAll_2023-06-06
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ReservationServiceOrderFilterParameters'
            example:
              ClientToken: E0D439EE522F44368DC78E1BFB03710C-D24FB11DBE31D4621C4817E028D9E1D
              AccessToken: C66EF7B239D24632943D115EDE9CB810-EA00F8FD8294692C940F6B5A8F9453D
              Client: Sample Client 1.0.0
              ReservationIds:
              - 0f515589-99b4-423d-b83a-b237009f0509
              - 9b59b50d-bd32-4ce5-add8-09ea0e1300e7
              ServiceIds:
              - bd26d8db-86da-4f96-9efc-e5a4654a4a94
              - 8c1bd738-a505-4b29-aa71-9ecc2982b843
              ReservationGroupIds:
              - 94843f6f-3be3-481b-a1c7-06458774c3df
              AccountIds:
              - fadd5bb6-b428-45d5-94f8-fd0d89fece6d
              PartnerCompanyIds:
              - c021013e-4930-4592-8e32-91b0b1fc9663
              TravelAgencyIds:
              - a793d381-65a2-4fa6-9514-00c4c5bfe607
              Numbers:
              - '50'
              - '51'
              - '52'
              - '53'
              AssignedResourceIds:
              - 5ee074b1-6c86-48e8-915f-c7aa4702086f
              - c32386aa-1cd2-414a-a823-489325842fbe
              AvailabilityBlockIds:
              - 5ee074b1-6c86-48e8-915f-c7aa4702086f
              - c32386aa-1cd2-414a-a823-489325842fbe
              CreatedUtc:
                StartUtc: '2023-04-01T00:00:00Z'
                EndUtc: '2023-05-05T00:00:00Z'
              UpdatedUtc:
                StartUtc: '2023-04-01T00:00:00Z'
                EndUtc: '2023-05-05T00:00:00Z'
              CollidingUtc:
                StartUtc: '2023-04-01T00:00:00Z'
                EndUtc: '2023-05-05T00:00:00Z'
              ScheduledStartUtc:
                StartUtc: '2023-04-01T00:00:00Z'
                EndUtc: '2023-05-05T00:00:00Z'
              ScheduledEndUtc:
                StartUtc: '2023-04-01T00:00:00Z'
                EndUtc: '2023-05-05T00:00:00Z'
              States:
              - Inquired
              - Confirmed
              EnterpriseIds:
              - 3fa85f64-5717-4562-b3fc-2c963f66afa6
              - 4d0201db-36f5-428b-8d11-4f0a65e960cc
              Limitation:
                Count: 10
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ReservationServiceOrderResult'
              example:
                Reservations:
                - Id: 0f515589-99b4-423d-b83a-b237009f0509
                  ServiceId: bd26d8db-86da-4f96-9efc-e5a4654a4a94
                  AccountId: fadd5bb6-b428-45d5-94f8-fd0d89fece6d
                  AccountType: Customer
                  CreatorProfileId: 3cd637ef-4728-47f9-8fb1-afb900c9cdcf
                  UpdaterProfileId: 3cd637ef-4728-47f9-8fb1-afb900c9cdcf
                  BookerId: ebd507c5-6bfd-4ca9-96aa-ffed6fa94f72
                  Number: '52'
                  State: Confirmed
                  Origin: Connector
                  CommanderOrigin: null
                  OriginDetails: null
                  CreatedUtc: '2023-03-23T16:00:00Z'
                  UpdatedUtc: '2023-04-22T17:00:00Z'
                  CancelledUtc: null
                  VoucherId: null
                  BusinessSegmentId: null
                  Options:
                    OwnerCheckedIn: true
                    AllCompanionsCheckedIn: true
                    AnyCompanionCheckedIn: true
                    ConnectorCheckIn: true
                  RateId: ed4b660b-19d0-434b-9360-a4de2ea42eda
                  CreditCardId: null
                  GroupId: 94843f6f-3be3-481b-a1c7-06458774c3df
                  RequestedResourceCategoryId: 773d5e42-de1e-43a0-9ce6-f940faf2303f
                  AssignedResourceId: 20e00c32-d561-4008-8609-82d8aa525714
                  AvailabilityBlockId: 5ee074b1-6c86-48e8-915f-c7aa4702086f
                  PartnerCompanyId: c021013e-4930-4592-8e32-91b0b1fc9663
                  TravelAgencyId: a793d381-65a2-4fa6-9514-00c4c5bfe607
                  AssignedResourceLocked: false
                  ChannelNumber: TW48ZP
                  ChannelManagerNumber: ''
                  CancellationReason: null
                  ReleasedUtc: null
                  StartUtc: '2023-04-23T14:00:00Z'
                  EndUtc: '2023-04-25T12:00:00Z'
                  ScheduledStartUtc: '2023-04-23T14:00:00Z'
                  ActualStartUtc: null
                  ScheduledEndUtc: '2023-04-25T12:00:00Z'
                  ActualEndUtc: null
                  Purpose: Leisure
                  QrCodeData: '{"Reservations":[{"Id":"0f515589-99b4-423d-b83a-b237009f0509","GroupId":"94843f6f-3be3-481b-a1c7-06458774c3df","CustomerId":"fadd5bb6-b428-45d5-94f8-fd0d89fece6d"}]}'
                  PersonCounts:
                  - AgeCategoryId: 1f67644f-052d-4863-acdf-ae1600c60ca0
                    Count: 2
                  - AgeCategoryId: ab58c939-be30-4a60-8f75-ae1600c60c9f
                    Count: 2
                Cursor: 0f515589-99b4-423d-b83a-b237009f0509
        '400':
          description: Error caused by the client app, e.g. in case of malformed request or invalid identifier of a resource. In most cases, such an error signifies a bug in the client app (consumer of the API).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectorApiExceptionResult'
        '401':
          description: Error caused by usage of invalid ClientToken, AccessToken, or you may not have the necessary permission to use the endpoint.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectorApiExceptionResult'
        '403':
          description: Server error that should be reported to the end user of the client app. Happens for example when the server-side validation fails or when a business-logic check is violated.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectorApiExceptionResult'
        '408':
          description: Error caused by heavy request that takes too long to process (typically tens of seconds). To get around this, request data in smaller batches. For more information, see [Request timeouts](https://mews-systems.gitbook.io/connector-api/guidelines/requests#request-timeouts)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectorApiExceptionResult'
        '204':
          description: Server has successfully fulfilled the request and there is no additional information to send back.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectorApiExceptionResult'
        '429':
          description: Error caused by too many requests sent in a given amount of time. Response contains `Retry-After` header indicating how long the user agent should wait before making a follow-up request. For more information, see [Request limits](https://mews-systems.gitbook.io/connector-api/guidelines/requests#request-limits).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectorApiExceptionResult'
        '500':
          description: Unexpected error on the Mews side. This may be due to a software fault. If such a situation occurs, the error will be logged and the development team notified, however you can raise an issue through GitHub on our [documentation repository](https://github.com/MewsSystems/gitbook-connector-api).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectorApiExceptionResult'
  /api/connector/v1/reservations/getAll:
    post:
      tags:
      - Reservations
      summary: Get all reservations (ver 2017-04-12)
      description: Use [Get all reservations (ver 2023-06-06)](https://mews-systems.gitbook.io/connector-api/operations/reservations#get-all-reservations-ver-2023-06-06).
      operationId: reservations_getAll
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ReservationFilterParameters'
            example:
              ClientToken: E0D439EE522F44368DC78E1BFB03710C-D24FB11DBE31D4621C4817E028D9E1D
              AccessToken: C66EF7B239D24632943D115EDE9CB810-EA00F8FD8294692C940F6B5A8F9453D
              Client: Sample Client 1.0.0
              StartUtc: '2016-01-01T00:00:00Z'
              EndUtc: '2016-01-07T00:00:00Z'
              ServiceIds:
              - bd26d8db-86da-4f96-9efc-e5a4654a4a94
              ReservationIds:
              - db6cad34-9a91-448b-bea1-abbe01240d9c
              CustomerIds:
              - 8e1d0ca6-1dde-4be0-8566-aafc01866110
              RateIds:
              - ed4b660b-19d0-434b-9360-a4de2ea42eda
              ChannelNumbers:
              - TW48ZP
              States:
              - Started
              Extent:
                Reservations: true
                ReservationGroups: true
                Customers: true
              Limitation:
                Cursor: e7f26210-10e7-462e-9da8-ae8300be8ab7
                Count: 10
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ReservationResult'
              example:
                BusinessSegments: null
                Customers:
                - Address: null
                  BirthDate: null
                  BirthPlace: null
                  CategoryId: null
                  Classifications: []
                  CreatedUtc: '2016-01-01T00:00:00Z'
                  Email: null
                  FirstName: John
                  Sex: null
                  Id: 35d4b117-4e60-44a3-9580-c582117eff98
                  IdentityCard: null
                  LanguageCode: null
                  LastName: Smith
                  LoyaltyCode: null
                  NationalityCode: US
                  Notes: ''
                  Number: '1'
                  Passport: null
                  Phone: 00420123456789
                  SecondLastName: null
                  TaxIdentificationNumber: null
                  Title: null
                  UpdatedUtc: '2016-01-01T00:00:00Z'
                  Visa: null
                OrderItems: null
                Products: null
                RateGroups: null
                Rates: null
                ReservationGroups:
                - Id: c704dff3-7811-4af7-a3a0-7b2b0635ac59
                  Name: 13-12-Smith-F712
                Reservations:
                - Id: bfee2c44-1f84-4326-a862-5289598f6e2d
                  ServiceId: bd26d8db-86da-4f96-9efc-e5a4654a4a94
                  GroupId: 94843f6f-3be3-481b-a1c7-06458774c3df
                  Number: '52'
                  ChannelNumber: TW48ZP
                  ChannelManager: ''
                  ChannelManagerGroupNumber: null
                  ChannelManagerNumber: null
                  State: Processed
                  Origin: Connector
                  OriginDetail: null
                  Purpose: Student
                  CreatedUtc: '2016-02-20T14:58:02Z'
                  UpdatedUtc: '2016-02-20T14:58:02Z'
                  CancelledUtc: null
                  StartUtc: '2016-02-20T13:00:00Z'
                  EndUtc: '2016-02-22T11:00:00Z'
                  ReleasedUtc: null
                  RequestedCategoryId: 773d5e42-de1e-43a0-9ce6-f940faf2303f
                  AssignedResourceId: 20e00c32-d561-4008-8609-82d8aa525714
                  AssignedResourceLocked: false
                  BusinessSegmentId: null
                  CompanyId: null
                  TravelAgencyId: null
                  AvailabilityBlockId: null
                  RateId: ed4b660b-19d0-434b-9360-a4de2ea42eda
                  VoucherId: null
                  CustomerId: 35d4b117-4e60-44a3-9580-c582117eff98
                  PersonCounts:
                  - AgeCategoryId: 1f67644f-052d-4863-acdf-ae1600c60ca0
                    Count: 2
                  - AgeCategoryId: ab58c939-be30-4a60-8f75-ae1600c60c9f
                    Count: 2
                Services: null
                Resources: null
                ResourceCategories: null
                ResourceCategoryAssignments: null
                Notes: null
                Cursor: 8d02142f-31cf-4115-90bf-ae5200c7a1ba
        '400':
          description: Error caused by the client app, e.g. in case of malformed request or invalid identifier of a resource. In most cases, such an error signifies a bug in the client app (consumer of the API).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectorApiExceptionResult'
        '401':
          description: Error caused by usage of invalid ClientToken, AccessToken, or you may not have the necessary permission to use the endpoint.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectorApiExceptionResult'
        '403':
          description: Server error that should be reported to the end user of the client app. Happens for example when the server-side validation fails or when a business-logic check is violated.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectorApiExceptionResult'
        '408':
          description: Error caused by heavy request that takes too long to process (typically tens of seconds). To get around this, request data in smaller batches. For more information, see [Request timeouts](https://mews-systems.gitbook.io/connector-api/guidelines/requests#request-timeouts)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectorApiExceptionResult'
        '204':
          description: Server has successfully fulfilled the request and there is no additional information to send back.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectorApiExceptionResult'
        '429':
          description: Error caused by too many requests sent in a given amount of time. Response contains `Retry-After` header indicating how long the user agent should wait before making a follow-up request. For more information, see [Request limits](https://mews-systems.gitbook.io/connector-api/guidelines/requests#request-limits).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectorApiExceptionResult'
        '500':
          description: Unexpected error on the Mews side. This may be due to a software fault. If such a situation occurs, the error will be logged and the development team notified, however you can raise an issue through GitHub on our [documentation repository](https://github.com/MewsSystems/gitbook-connector-api).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectorApiExceptionResult'
      deprecated: true
      x-deprecatedMessage: Use [Get all reservations (ver 2023-06-06)](https://mews-systems.gitbook.io/connector-api/operations/reservations#get-all-reservations-ver-2023-06-06).
  /api/connector/v1/reservations/price:
    post:
      tags:
      - Reservations
      summary: Price reservations
      description: "Returns prices of reservations with the specified parameters.\r\nNote that the operation doesn't check the maximum capacity of requested resource category. Requesting person counts above the capacity will return prices for the maximum available capacity.\r\n\r\nThis operation supports [Portfolio Access Tokens](https://mews-systems.gitbook.io/connector-api/concepts/multi-property/)."
      operationId: reservations_price
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ReservationDataParameters'
            example:
              ClientToken: E0D439EE522F44368DC78E1BFB03710C-D24FB11DBE31D4621C4817E028D9E1D
              AccessToken: C66EF7B239D24632943D115EDE9CB810-EA00F8FD8294692C940F6B5A8F9453D
              Client: Sample Client 1.0.0
              EnterpriseId: 3fa85f64-5717-4562-b3fc-2c963f66afa6
              ServiceId: bd26d8db-86da-4f96-9efc-e5a4654a4a94
              Reservations:
              - Identifier: '1234'
                StartUtc: '2018-01-01T14:00:00Z'
                EndUtc: '2018-01-02T10:00:00Z'
                RequestedCategoryId: 0a5da171-3663-4496-a61e-35ecbd78b9b1
                RateId: 33667cab-f17f-4089-ad07-c2cd50fa0df1
                Notes: Test reservation
                ProductOrders:
                - ProductId: 3dc5d79b-67ce-48ed-9238-47fcf5d1a59f
                PersonCounts:
                - AgeCategoryId: 1f67644f-052d-4863-acdf-ae1600c60ca0
                  Count: 2
                - AgeCategoryId: ab58c939-be30-4a60-8f75-ae1600c60c9f
                  Count: 2
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ReservationPricingResult'
              example:
                ReservationPrices:
                - Identifier: '1234'
                  Total:
                    Currency: GBP
                    NetValue: 20
                    GrossValue: 23
                    TaxValues:
                    - Code: UK-S
                      Value: 3
        '400':
          description: Error caused by the client app, e.g. in case of malformed request or invalid identifier of a resource. In most cases, such an error signifies a bug in the client app (consumer of the API).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectorApiExceptionResult'
        '401':
          description: Error caused by usage of invalid ClientToken, AccessToken, or you may not have the necessary permission to use the endpoint.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectorApiExceptionResult'
        '403':
          description: Server error that should be reported to the end user of the client app. Happens for example when the server-side validation fails or when a business-logic check is violated.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectorApiExceptionResult'
        '408':
          description: Error caused by heavy request that takes too long to process (typically tens of seconds). To get around this, request data in smaller batches. For more information, see [Request timeouts](https://mews-systems.gitbook.io/connector-api/guidelines/requests#request-timeouts)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectorApiExceptionResult'
        '204':
          description: Server has successfully fulfilled the request and there is no additional information to send back.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectorApiExceptionResult'
        '429':
          description: Error caused by too many requests sent in a given amount of time. Response contains `Retry-After` header indicating how long the user agent should wait before making a follow-up request. For more information, see [Request limits](https://mews-systems.gitbook.io/connector-api/guidelines/requests#request-limits).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectorApiExceptionResult'
        '500':
          description: Unexpected error on the Mews side. This may be due to a software fault. If such a situation occurs, the error will be logged and the development team notified, however you can raise an issue through GitHub on our [documentation repository](https://github.com/MewsSystems/gitbook-connector-api).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectorApiExceptionResult'
  /api/connector/v1/reservations/add:
    post:
      tags:
      - Reservations
      summary: Add reservations
      description: Adds the specified reservations as a single group. If `GroupId` is specified, adds the reservations to an already existing group. Note that all reservations linked to an availability block must belong to the same reservation group.
      operationId: reservations_add
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ReservationAdditionParameters'
            example:
              ClientToken: E0D439EE522F44368DC78E1BFB03710C-D24FB11DBE31D4621C4817E028D9E1D
              AccessToken: C66EF7B239D24632943D115EDE9CB810-EA00F8FD8294692C940F6B5A8F9453D
              Client: Sample Client 1.0.0
              ServiceId: bd26d8db-86da-4f96-9efc-e5a4654a4a94
              GroupId: null
              GroupName: null
              SendConfirmationEmail: true
              Reservations:
              - Identifier: '1234'
                State: Confirmed
                StartUtc: '2021-01-01T14:00:00Z'
                EndUtc: '2021-01-03T10:00:00Z'
                ReleasedUtc: null
                CustomerId: e465c031-fd99-4546-8c70-abcf0029c249
                BookerId: e465c031-fd99-4546-8c70-abcf0029c249
                RequestedCategoryId: 0a5da171-3663-4496-a61e-35ecbd78b9b1
                RateId: a39a59fa-3a08-4822-bdd4-ab0b00e3d21f
                TravelAgencyId: null
                CompanyId: null
                Notes: Test reservation
                TimeUnitAmount: null
                PersonCounts:
                - AgeCategoryId: 1f67644f-052d-4863-acdf-ae1600c60ca0
                  Count: 2
                - AgeCategoryId: ab58c939-be30-4a60-8f75-ae1600c60c9f
                  Count: 2
                TimeUnitPrices:
                - Index: 0
                  Amount:
                    Currency: GBP
                    GrossValue: 20
                    TaxCodes:
                    - UK-S
                - Index: 1
                  Amount:
                    Currency: GBP
                    GrossValue: 30
                    TaxCodes:
                    - UK-S
                ProductOrders:
                - ProductId: 2e9eb3fc-8a77-466a-9cd9-abcf002a2a01
                  StartUtc: '2021-01-02T00:00:00Z'
                  EndUtc: '2021-01-03T00:00:00Z'
                AvailabilityBlockId: null
                VoucherCode: SpringSale2021
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ReservationAdditionResult'
              example:
                Reservations:
                - Identifier: '1234'
                  Reservation:
                    Id: bfee2c44-1f84-4326-a862-5289598f6e2d
                    ServiceId: bd26d8db-86da-4f96-9efc-e5a4654a4a94
                    GroupId: 94843f6f-3be3-481b-a1c7-06458774c3df
                    Number: '52'
                    ChannelManager: ''
                    ChannelManagerGroupNumber: null
                    ChannelManagerNumber: null
                    ChannelNumber: null
                    State: Processed
                    Origin: Connector
                    CreatedUtc: '2016-02-20T14:58:02Z'
                    UpdatedUtc: '2016-02-20T14:58:02Z'
                    CancelledUtc: null
                    StartUtc: '2016-02-20T13:00:00Z'
                    EndUtc: '2016-02-22T11:00:00Z'
                    ReleasedUtc: null
                    RequestedCategoryId: 773d5e42-de1e-43a0-9ce6-f940faf2303f
                    AssignedResourceId: 20e00c32-d561-4008-8609-82d8aa525714
                    AssignedResourceLocked: false
                    BusinessSegmentId: null
                    CompanyId: null
                    TravelAgencyId: null
                    AvailabilityBlockId: null
                    RateId: ed4b660b-19d0-434b-9360-a4de2ea42eda
                    VoucherId: null
                    CustomerId: 35d4b117-4e60-44a3-9580-c582117eff98
                    CompanionIds:
                    - b22bf671-ccdf-40aa-a7e6-b20a4f91d79a
        '400':
          description: Error caused by the client app, e.g. in case of malformed request or invalid identifier of a resource. In most cases, such an error signifies a bug in the client app (consumer of the API).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectorApiExceptionResult'
        '401':
          description: Error caused by usage of invalid ClientToken, AccessToken, or you may not have the necessary permission to use the endpoint.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectorApiExceptionResult'
        '403':
          description: Server error that should be reported to the end user of the client app. Happens for example when the server-side validation fails or when a business-logic check is violated.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectorApiExceptionResult'
        '408':
          description: Error caused by heavy request that takes too long to process (typically tens of seconds). To get around this, request data in smaller batches. For more information, see [Request timeouts](https://mews-systems.gitbook.io/connector-api/guidelines/requests#request-timeouts)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectorApiExceptionResult'
        '204':
          description: Server has successfully fulfilled the request and there is no additional information to send back.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectorApiExceptionResult'
        '429':
          description: Error caused by too many requests sent in a given amount of time. Response contains `Retry-After` header indicating how long the user agent should wait before making a follow-up request. For more information, see [Request limits](https://mews-systems.gitbook.io/connector-api/guidelines/requests#request-limits).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/C

# --- truncated at 32 KB (260 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/mews/refs/heads/main/openapi/mews-reservations-api-openapi.yml