openapi: 3.0.4 info: title: Mews Booking Engine API (Distributor) Account notes Customers API version: v1 description: The Mews Booking Engine API (historically the Distributor API, served from /api/distributor/v1) lets developers build guest-facing booking engines that create reservations directly in Mews. It exposes enterprise configuration, availability, pricing, products, vouchers, payment cards, and reservation group creation for front-end client consumption. x-generated-from: documentation x-source-url: https://api.mews.com/Swagger/distributor/swagger.json x-last-validated: '2026-06-02' servers: - url: https://api.mews.com description: Production - url: https://api.mews-demo.com description: Demo / sandbox security: - MewsClientToken: [] MewsAccessToken: [] tags: - name: Customers paths: /api/connector/v1/customers/getAll: post: tags: - Customers summary: Mews Get All Customers description: 'Returns all customers filtered by identifiers, emails, names and other filters. Note 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: customers_getAll requestBody: content: application/json: schema: $ref: '#/components/schemas/CustomerFilterParameters' example: ClientToken: E0D439EE522F44368DC78E1BFB03710C-D24FB11DBE31D4621C4817E028D9E1D AccessToken: C66EF7B239D24632943D115EDE9CB810-EA00F8FD8294692C940F6B5A8F9453D Client: Sample Client 1.0.0 ChainIds: - 3fa85f64-5717-4562-b3fc-2c963f66afa6 - 5fcd1933-22f2-40b9-84da-7db04cbecec2 CreatedUtc: StartUtc: '2018-01-01T00:00:00Z' EndUtc: '2018-01-30T00:00:00Z' UpdatedUtc: StartUtc: '2018-01-02T00:00:00Z' EndUtc: '2018-01-30T00:00:00Z' Extent: Customers: true Documents: false Addresses: false ActivityStates: - Active CustomerIds: - fadd5bb6-b428-45d5-94f8-fd0d89fece6d CompanyIds: - c6f5c82d-621a-4c8a-903b-1b0a9a23b71f Emails: - j.smith@example.com FirstNames: - John - Jane LastNames: - Doe - Smith LoyaltyCodes: - LL810213 Limitation: Count: 10 responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/CustomerResult' example: Customers: - Id: fadd5bb6-b428-45d5-94f8-fd0d89fece6d ChainId: 3fa85f64-5717-4562-b3fc-2c963f66afa6 Number: '12345' Title: Mister Sex: Male FirstName: John LastName: Smith SecondLastName: Williams NationalityCode: US PreferredLanguageCode: en-GB LanguageCode: en-US BirthDate: '1983-12-31' BirthCountryCode: null BirthCountrySubdivisionCode: null BirthPlace: New York City, NY Occupation: Carpenter Email: j.smith@example.com HasOtaEmail: false Phone: 00420123456789 TaxIdentificationNumber: '123456789' LoyaltyCode: LL810213 AccountingCode: AC123 BillingCode: null Notes: '' CarRegistrationNumber: 1A2 3456 DietaryRequirements: null CreatedUtc: '2018-01-01T00:00:00Z' UpdatedUtc: '2018-01-02T00:00:00Z' Passport: null IdentityCard: null Visa: null DriversLicense: null Address: Id: f8495413-bf49-45dd-843c-44be7f365569 Line1: Somerford Road Hello House/135 Line2: null City: Christchurch PostalCode: BH23 3PY CountryCode: GB CountrySubdivisionCode: GB-ENG Latitude: null Longitude: null AddressId: f8495413-bf49-45dd-843c-44be7f365569 Classifications: - Returning Options: - SendMarketingEmails ItalianDestinationCode: null ItalianFiscalCode: null ItalianLotteryCode: null CompanyId: c6f5c82d-621a-4c8a-903b-1b0a9a23b71f MergeTargetId: null ActivityState: Active IsActive: true PreferredSpaceFeatures: - OceanView CreatorProfileId: 3cd637ef-4728-47f9-8fb1-afb900c9cdcf UpdaterProfileId: 122fc063-ec6e-4198-b8db-6b168a59ffae Documents: null Cursor: fadd5bb6-b428-45d5-94f8-fd0d89fece6d '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' examples: CustomersGetAll400Example: summary: Default customers_getAll 400 response x-microcks-default: true value: Message: string RequestId: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 Details: string '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' examples: CustomersGetAll401Example: summary: Default customers_getAll 401 response x-microcks-default: true value: Message: string RequestId: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 Details: string '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' examples: CustomersGetAll403Example: summary: Default customers_getAll 403 response x-microcks-default: true value: Message: string RequestId: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 Details: string '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' examples: CustomersGetAll408Example: summary: Default customers_getAll 408 response x-microcks-default: true value: Message: string RequestId: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 Details: string '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' examples: CustomersGetAll204Example: summary: Default customers_getAll 204 response x-microcks-default: true value: Message: string RequestId: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 Details: string '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' examples: CustomersGetAll429Example: summary: Default customers_getAll 429 response x-microcks-default: true value: Message: string RequestId: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 Details: string '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' examples: CustomersGetAll500Example: summary: Default customers_getAll 500 response x-microcks-default: true value: Message: string RequestId: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 Details: string x-microcks-operation: delay: 0 dispatcher: FALLBACK /api/connector/v1/customers/search: post: tags: - Customers summary: Mews Search Customers description: Searches for customers that are active at the moment in the enterprise (e.g. companions of checked-in reservations or paymasters). operationId: customers_search requestBody: content: application/json: schema: $ref: '#/components/schemas/CustomerSearchParameters' example: ClientToken: E0D439EE522F44368DC78E1BFB03710C-D24FB11DBE31D4621C4817E028D9E1D AccessToken: C66EF7B239D24632943D115EDE9CB810-EA00F8FD8294692C940F6B5A8F9453D Client: Sample Client 1.0.0 Name: Smith ResourceId: null Extent: Customers: true Documents: false Addresses: false responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/CustomerSearchResult' example: Customers: - Customer: Id: fadd5bb6-b428-45d5-94f8-fd0d89fece6d ChainId: 3fa85f64-5717-4562-b3fc-2c963f66afa6 Number: '12345' Title: Mister Sex: Male FirstName: John LastName: Smith SecondLastName: Williams NationalityCode: US PreferredLanguageCode: en-GB LanguageCode: en-US BirthDate: '1983-12-31' BirthCountryCode: null BirthCountrySubdivisionCode: null BirthPlace: New York City, NY Occupation: Carpenter Email: j.smith@example.com HasOtaEmail: false Phone: 00420123456789 TaxIdentificationNumber: '123456789' LoyaltyCode: LL810213 AccountingCode: AC123 BillingCode: null Notes: '' CarRegistrationNumber: 1A2 3456 DietaryRequirements: null CreatedUtc: '2018-01-01T00:00:00Z' UpdatedUtc: '2018-01-02T00:00:00Z' Passport: null IdentityCard: null Visa: null DriversLicense: null Address: Id: f8495413-bf49-45dd-843c-44be7f365569 Line1: Somerford Road Hello House/135 Line2: null City: Christchurch PostalCode: BH23 3PY CountryCode: GB CountrySubdivisionCode: GB-ENG Latitude: null Longitude: null AddressId: f8495413-bf49-45dd-843c-44be7f365569 Classifications: - Returning Options: - SendMarketingEmails ItalianDestinationCode: null ItalianFiscalCode: null ItalianLotteryCode: null CompanyId: c6f5c82d-621a-4c8a-903b-1b0a9a23b71f MergeTargetId: null ActivityState: Active IsActive: true PreferredSpaceFeatures: - OceanView CreatorProfileId: 3cd637ef-4728-47f9-8fb1-afb900c9cdcf UpdaterProfileId: 122fc063-ec6e-4198-b8db-6b168a59ffae Reservation: null Documents: null '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' examples: CustomersSearch400Example: summary: Default customers_search 400 response x-microcks-default: true value: Message: string RequestId: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 Details: string '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' examples: CustomersSearch401Example: summary: Default customers_search 401 response x-microcks-default: true value: Message: string RequestId: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 Details: string '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' examples: CustomersSearch403Example: summary: Default customers_search 403 response x-microcks-default: true value: Message: string RequestId: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 Details: string '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' examples: CustomersSearch408Example: summary: Default customers_search 408 response x-microcks-default: true value: Message: string RequestId: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 Details: string '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' examples: CustomersSearch204Example: summary: Default customers_search 204 response x-microcks-default: true value: Message: string RequestId: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 Details: string '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' examples: CustomersSearch429Example: summary: Default customers_search 429 response x-microcks-default: true value: Message: string RequestId: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 Details: string '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' examples: CustomersSearch500Example: summary: Default customers_search 500 response x-microcks-default: true value: Message: string RequestId: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 Details: string x-microcks-operation: delay: 0 dispatcher: FALLBACK /api/connector/v1/customers/getOpenItems: post: tags: - Customers summary: Mews Get Customers Open Items description: Use [Get all payments](https://mews-systems.gitbook.io/connector-api/operations/payments#get-all-payments) and [Get all order items](https://mews-systems.gitbook.io/connector-api/operations/orderitems#get-all-order-items) instead. operationId: customers_getOpenItems requestBody: content: application/json: schema: $ref: '#/components/schemas/CustomerItemParameters' example: ClientToken: E0D439EE522F44368DC78E1BFB03710C-D24FB11DBE31D4621C4817E028D9E1D AccessToken: C66EF7B239D24632943D115EDE9CB810-EA00F8FD8294692C940F6B5A8F9453D Client: Sample Client 1.0.0 CustomerIds: - 2a1a4315-7e6f-4131-af21-402cec59b8b9 responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/CustomerItemResult' example: Customers: - CustomerId: 2a1a4315-7e6f-4131-af21-402cec59b8b9 OrderItems: - Id: 35820535-b988-4d6f-80cf-ecb19cdc3e58 AccountId: 2a1a4315-7e6f-4131-af21-402cec59b8b9 OrderId: 6645113e-72cc-4f99-ab77-e4452911bf20 BillId: null AccountingCategoryId: d250149e-a29d-4c70-b607-a1759faf7320 Amount: Currency: GBP NetValue: -5 GrossValue: -5 TaxValues: - Code: UK-Z Value: 0 Breakdown: Items: - TaxRateCode: UK-Z NetValue: -5 TaxValue: 0 RevenueType: Additional ConsumedUtc: '2017-04-04T15:13:39Z' ClosedUtc: null AccountingState: Open Data: Discriminator: Rebate Value: RebatedItemId: null PaymentItems: [] '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' examples: CustomersGetOpenItems400Example: summary: Default customers_getOpenItems 400 response x-microcks-default: true value: Message: string RequestId: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 Details: string '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' examples: CustomersGetOpenItems401Example: summary: Default customers_getOpenItems 401 response x-microcks-default: true value: Message: string RequestId: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 Details: string '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' examples: CustomersGetOpenItems403Example: summary: Default customers_getOpenItems 403 response x-microcks-default: true value: Message: string RequestId: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 Details: string '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' examples: CustomersGetOpenItems408Example: summary: Default customers_getOpenItems 408 response x-microcks-default: true value: Message: string RequestId: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 Details: string '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' examples: CustomersGetOpenItems204Example: summary: Default customers_getOpenItems 204 response x-microcks-default: true value: Message: string RequestId: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 Details: string '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' examples: CustomersGetOpenItems429Example: summary: Default customers_getOpenItems 429 response x-microcks-default: true value: Message: string RequestId: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 Details: string '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' examples: CustomersGetOpenItems500Example: summary: Default customers_getOpenItems 500 response x-microcks-default: true value: Message: string RequestId: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 Details: string deprecated: true x-deprecatedMessage: Use [Get all payments](https://mews-systems.gitbook.io/connector-api/operations/payments#get-all-payments) and [Get all order items](https://mews-systems.gitbook.io/connector-api/operations/orderitems#get-all-order-items) instead. x-microcks-operation: delay: 0 dispatcher: FALLBACK /api/connector/v1/customers/add: post: tags: - Customers summary: Mews Add Customer description: Adds a new customer to the system and returns details of the added customer. If a customer with the specified email already exists, and `OverwriteExisting` is set to `true`, then the existing customer profile information is overwritten and the existing customer data returned. If `OverwriteExisting` is set to `false`, an error response is returned. Note this operation supports [Portfolio Access Tokens](https://mews-systems.gitbook.io/connector-api/concepts/multi-property). operationId: customers_add requestBody: content: application/json: schema: $ref: '#/components/schemas/CustomerAddParameters' example: ClientToken: E0D439EE522F44368DC78E1BFB03710C-D24FB11DBE31D4621C4817E028D9E1D AccessToken: C66EF7B239D24632943D115EDE9CB810-EA00F8FD8294692C940F6B5A8F9453D Client: Sample Client 1.0.0 Title: Miss FirstName: Thea LastName: Carbone BirthDate: '1985-09-30' BirthPlace: Pescara (BI) Occupation: Giornalista Email: thea@quotidiano.example Phone: +39 06 555 5555 Notes: Check-in notturno. CarRegistrationNumber: AA 111AA TaxIdentificationNumber: ZGNZLR17U72P554F Address: Line1: Via Antimo 474 Piano 5 City: Liborio laziale PostalCode: '30228' CountryCode: IT CountrySubdivisionCode: IT-65 Classifications: - Media - FriendOrFamily Options: - SendMarketingEmails ChainId: 3fa85f64-5717-4562-b3fc-2c963f66afa6 OverwriteExisting: false ItalianDestinationCode: '7654321' ItalianFiscalCode: ZGNZLR17U72P554F ItalianLotteryCode: AB12345 responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/Customer' example: Id: 99b4f0af-9558-463b-8452-07a9bc414708 ChainId: 3fa85f64-5717-4562-b3fc-2c963f66afa6 Number: '390881' Title: Miss Sex: null FirstName: Thea LastName: Carbone SecondLastName: null NationalityCode: null PreferredLanguageCode: null LanguageCode: null BirthDate: '1985-09-30' BirthCountryCode: null BirthCountrySubdivisionCode: null BirthPlace: Pescara (BI) Occupation: Giornalista Email: thea@quotidiano.example HasOtaEmail: false Phone: +39 06 555 5555 TaxIdentificationNumber: ZGNZLR17U72P554F LoyaltyCode: null AccountingCode: null BillingCode: null Notes: Check-in notturno. CarRegistrationNumber: AA 111AA DietaryRequirements: null CreatedUtc: '2024-09-17T12:22:33Z' UpdatedUtc: '2024-10-12T09:45:00Z' Passport: null IdentityCard: null Visa: null DriversLicense: null Address: Id: 81f62f08-26d5-408f-9b0d-d030957dc799 Line1: Via Antimo 474 Piano 5 Line2: null City: Liborio laziale PostalCode: '30228' CountryCode: IT CountrySubdivisionCode: IT-65 Latitude: 28.56333 Longitude: -121.243143 AddressId: 81f62f08-26d5-408f-9b0d-d030957dc799 Classifications: - Media - FriendOrFamily Options: [] ItalianDestinationCode: '7654321' ItalianFiscalCode: ZGNZLR17U72P554F ItalianLotteryCode: AB12345 CompanyId: f3b4f0af-9558-463b-8452-07a9bc414708 MergeTargetId: null ActivityState: null IsActive: true PreferredSpaceFeatures: - LowerBed CreatorProfileId: 3cd637ef-4728-47f9-8fb1-afb900c9cdcf UpdaterProfileId: 122fc063-ec6e-4198-b8db-6b168a59ffae '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' examples: CustomersAdd400Example: summary: Default customers_add 400 response x-microcks-default: true value: Message: string RequestId: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 Details: string '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' examples: CustomersAdd401Example: summary: Default customers_add 401 response x-microcks-default: true value: Message: string RequestId: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 Details: string '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' examples: CustomersAdd403Example: summary: Default customers_add 403 response x-microcks-default: true value: Message: string RequestId: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 Details: string '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' examples: CustomersAdd408Example: summary: Default customers_add 408 response x-microcks-default: true value: Message: string RequestId: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 Details: string '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' examples: CustomersAdd204Example: summary: Default customers_add 204 response x-microcks-default: true value: Message: string RequestId: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 Details: string '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' examples: CustomersAdd429Example: summary: Default customers_add 429 response x-microcks-default: true value: Message: string RequestId: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 Details: string '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' examples: CustomersAdd500Example: summary: Default customers_add 500 response x-microcks-default: true value: Message: string RequestId: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 Details: string x-microcks-operation: delay: 0 dispatcher: FALLBACK /api/connector/v1/customers/update: post: tags: - Customers summary: Mews Update Customer description: Updates personal information of a customer. Note that if any of the fields is left blank, it won't clear the field in Mews. The field will be left intact. In case of email update, the email will change in Mews only if there is no other customer profile in the hotel with such email. Otherwise an error response is returned. Note this operation supports [Portfolio Access Tokens](https://mews-systems.gitbook.io/connector-api/concepts/multi-property). operationId: customers_update requestBody: content: application/json: schema: $ref: '#/components/schemas/CustomerUpdateParameters' example: ClientToken: E0D439EE522F44368DC78E1BFB03710C-D24FB11DBE31D4621C4817E028D9E1D AccessToken: C66EF7B239D24632943D115EDE9CB810-EA00F8FD8294692C940F6B5A8F9453D Client: Sample Client 1.0.0 ChainId: 3fa85f64-5717-4562-b3fc-2c963f66afa6 CustomerId: 99b4f0af-9558-463b-8452-07a9bc414708 Title: Miss FirstName: Thea LastName: Carbone BirthDate: '1985-09-30' BirthPlace: Pescara (BI) Occupation: Giornalista Email: thea@quotidiano.example Phone: +39 06 555 5555 Notes: Check-in notturno. CarRegistrationNumber: AA 111AA TaxIdentificationNumber: ZGNZLR17U72P554F CompanyId: f3b4f0af-9558-463b-8452-07a9bc414708 Address: Line1: Via Antimo 474 Piano 5 City: Liborio laziale PostalCode: '30228' CountryCode: IT CountrySubdivisionCode: IT-65 Classifications: - Media - FriendOrFamily Options: - SendMarketingEmails ItalianDestinationCode: Value: '7654321' ItalianFiscalCode: Value: ZGNZLR17U72P554F ItalianLotteryCode: Value: AB12345 responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/Customer' example: Id: 99b4f0af-9558-463b-8452-07a9bc414708 ChainId: 3fa85f64-5717-4562-b3fc-2c963f66afa6 Number: '390881' Title: Miss Sex: null FirstName: Thea LastName: Carbone SecondLastName: null NationalityCode: null PreferredLanguageCode: null LanguageCode: null BirthDate: '1985-09-30' BirthCountryCode: null BirthCountrySubdivisionCode: null BirthPlace: Pescara (BI) Occupation: Giornalista Email: thea@quotidiano.example HasOtaEmail: false Phone: +39 06 555 5555 TaxIdentificationNumber: ZGNZLR17U72P554F LoyaltyCode: null AccountingCode: null BillingCode: null Notes: Check-in notturno. CarRegistrationNumber: AA 111AA DietaryRequirements: null CreatedUtc: '2024-09-17T12:22:33Z' UpdatedUtc: '2024-10-12T09:45:00Z' Passport: null IdentityCard: null Visa: null DriversLicense: null Address: Id: 81f62f08-26d5-408f-9b0d-d030957dc799 Line1: Via Antimo 474 Piano 5 Line2: null City: Liborio laziale PostalCode: '30228' CountryCode: IT CountrySubdivisionCode: IT-65 Latitude: 28.56333 Longitude: -121.243143 AddressId: 81f62f08-26d5-408f-9b0d-d030957dc799 Classifications: - Media - FriendOrFamily Options: [] ItalianDestinationCode: '7654321' ItalianFiscalCode: ZGNZLR17U72P554F ItalianLotteryCode: AB12345 CompanyId: f3b4f0af-9558-463b-8452-07a9bc414708 MergeTargetId: null ActivityState: null IsActive: true PreferredSpaceFeatures: - LowerBed CreatorProfileId: 3cd637ef-4728-47f9-8fb1-afb900c9cdcf UpdaterProfileId: 122fc063-ec6e-4198-b8db-6b168a59ffae '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' examples: CustomersUpdate400Example: summary: Default customers_update 400 response x-microcks-default: true value: Message: string RequestId: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 Details: string '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' examples: CustomersUpdate401Example: summary: Default customers_update 401 response x-microcks-default: true value: Message: string RequestId: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 Details: string '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' examples: CustomersUpdate403Example: summary: Default customers_update 403 response x-microcks-default: true value: Message: string RequestId: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 Details: string '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' examples: CustomersUpdate408Example: summary: Default customers_update 408 response x-microcks-default: true value: Message: string RequestId: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 Details: string '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' examples: CustomersUpdate204Example: summary: Default customers_update 204 response x-microcks-default: true value: Message: string RequestId: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 Details: string '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' examples: CustomersUpdate429Example: summary: Default customers_update 429 response x-microcks-default: true value: Message: string RequestId: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 Details: string '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' examples: CustomersUpdate500Example: summary: Default customers_update 500 response x-microcks-default: true value: Message: string RequestId: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 Details: string x-microcks-operation: delay: 0 dispatcher: FALLBACK /api/connector/v1/customers/merge: post: tags: - Customers summary: Mews Merge Customers description: Use [Merge accounts](https://mews-systems.gitbook.io/connector-api/operations/accounts#merge-accounts) instead. operationId: customers_merge requestBody: content: application/json: schema: $ref: '#/components/schemas/CustomerMergeParameters' example: ClientToken: E0D439EE522F44368DC78E1BFB03710C-D24FB11DBE31D4621C4817E028D9E1D AccessToken: C66EF7B239D24632943D115EDE9CB810-EA00F8FD8294692C940F6B5A8F9453D Client: Sample Client 1.0.0 SourceCustomerId: e11801ff-4148-4010-87f3-0d111e2893e3 TargetCustomerId: 35d4b117-4e60-44a3-9580-c582117eff98 responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/Unit' examples: CustomersMerge200Example: summary: Default customers_merge 200 response x-microcks-default: true value: {} '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' examples: CustomersMerge400Example: summary: Default customers_merge 400 response x-microcks-default: true value: Message: string RequestId: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 Details: string '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' examples: CustomersMerge401Example: summary: Default customers_merge 401 response x-microcks-default: true value: Message: string RequestId: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 Details: string '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' examples: CustomersMerge403Example: summary: Default customers_merge 403 response x-microcks-default: true value: Message: string RequestId: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 Details: string '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' examples: CustomersMerge408Example: summary: Default customers_merge 408 response x-microcks-default: true value: Message: string RequestId: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 Details: string '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' examples: CustomersMerge204Example: summary: Default customers_merge 204 response x-microcks-default: true value: Message: string RequestId: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 Details: string '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' examples: CustomersMerge429Example: summary: Default customers_merge 429 response x-microcks-default: true value: Message: string RequestId: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 Details: string '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' examples: CustomersMerge500Example: summary: Default customers_merge 500 response x-microcks-default: true value: Message: string RequestId: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 Details: string deprecated: true x-deprecatedMessage: Use [Merge accounts](https://mews-systems.gitbook.io/connector-api/operations/accounts#merge-accounts) instead. x-microcks-operation: delay: 0 dispatcher: FALLBACK /api/connector/v1/customers/addFile: post: tags: - Customers summary: Mews Add Customer File description: "Attaches the specified file to the customer profile. \r\n\r\nAllowed MIME types: `application/pdf`, `image/bmp`, `image/gif`, `image/jpeg`, `image/png`, `image/tiff`.\r\n\r\nNote this operation supports [Portfolio Access Tokens](https://mews-systems.gitbook.io/connector-api/guidelines/multi-property)." operationId: customers_addFile requestBody: content: application/json: schema: $ref: '#/components/schemas/CustomerFileParameters' example: ClientToken: E0D439EE522F44368DC78E1BFB03710C-D24FB11DBE31D4621C4817E028D9E1D AccessToken: C66EF7B239D24632943D115EDE9CB810-EA00F8FD8294692C940F6B5A8F9453D Client: Sample Client 1.0.0 CustomerId: 3fa85f64-5717-4562-b3fc-2c963f66afa6 Name: document.pdf Type: application/pdf Data: JVBERi0xLjAKMSAwIG9iajw8L1BhZ2VzIDIgMCBSPj5lbmRvYmogMiAwIG9iajw8L0tpZHNbMyAwIFJdL0NvdW50IDE+PmVuZG9iaiAzIDAgb2JqPDwvTWVkaWFCb3hbMCAwIDMgM10+PmVuZG9iagp0cmFpbGVyPDwvUm9vdCAxIDAgUj4+Cg== ChainId: 3fa85f64-5717-4562-b3fc-2c963f66afa6 responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/CustomerAddFileResult' example: FileId: f039f5b4-ff18-4510-9086-92b14a68ed78 '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' examples: CustomersAddFile400Example: summary: Default customers_addFile 400 response x-microcks-default: true value: Message: string RequestId: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 Details: string '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' examples: CustomersAddFile401Example: summary: Default customers_addFile 401 response x-microcks-default: true value: Message: string RequestId: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 Details: string '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' examples: CustomersAddFile403Example: summary: Default customers_addFile 403 response x-microcks-default: true value: Message: string RequestId: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 Details: string '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' examples: CustomersAddFile408Example: summary: Default customers_addFile 408 response x-microcks-default: true value: Message: string RequestId: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 Details: string '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' examples: CustomersAddFile204Example: summary: Default customers_addFile 204 response x-microcks-default: true value: Message: string RequestId: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 Details: string '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' examples: CustomersAddFile429Example: summary: Default customers_addFile 429 response x-microcks-default: true value: Message: string RequestId: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 Details: string '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' examples: CustomersAddFile500Example: summary: Default customers_addFile 500 response x-microcks-default: true value: Message: string RequestId: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 Details: string x-microcks-operation: delay: 0 dispatcher: FALLBACK /api/connector/v1/customers/getRelationships: post: tags: - Customers summary: Mews Get Customers Relationships description: Returns relationships between customers (e.g. Spouse, Friend) for the provided unique identifiers of customers. operationId: customers_getRelationships requestBody: content: application/json: schema: $ref: '#/components/schemas/CustomerRelationshipFilterParameters' example: ClientToken: E0D439EE522F44368DC78E1BFB03710C-D24FB11DBE31D4621C4817E028D9E1D AccessToken: C66EF7B239D24632943D115EDE9CB810-EA00F8FD8294692C940F6B5A8F9453D Client: Sample Client 1.0.0 CustomerIds: - fadd5bb6-b428-45d5-94f8-fd0d89fece6d - bccdafd1-3e44-439d-861f-341526b597a9 ChainIds: - 3fa85f64-5717-4562-b3fc-2c963f66afa6 - 5fcd1933-22f2-40b9-84da-7db04cbecec2 Limitation: Count: 100 responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/CustomerRelationshipResult' example: CustomerRelationships: - CustomerId: cbe8a32e-3eb7-4226-baf4-69455a0eeaf5 RelatedCustomerId: cbe8a32e-3eb7-4226-baf4-69455a0eeaf6 Relationship: Other - CustomerId: cbe8a32e-3eb7-4226-baf4-69455a0eeaf6 RelatedCustomerId: cbe8a32e-3eb7-4226-baf4-69455a0eeaf5 Relationship: Other Cursor: null '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' examples: CustomersGetRelationships400Example: summary: Default customers_getRelationships 400 response x-microcks-default: true value: Message: string RequestId: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 Details: string '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' examples: CustomersGetRelationships401Example: summary: Default customers_getRelationships 401 response x-microcks-default: true value: Message: string RequestId: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 Details: string '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' examples: CustomersGetRelationships403Example: summary: Default customers_getRelationships 403 response x-microcks-default: true value: Message: string RequestId: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 Details: string '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' examples: CustomersGetRelationships408Example: summary: Default customers_getRelationships 408 response x-microcks-default: true value: Message: string RequestId: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 Details: string '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' examples: CustomersGetRelationships204Example: summary: Default customers_getRelationships 204 response x-microcks-default: true value: Message: string RequestId: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 Details: string '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' examples: CustomersGetRelationships429Example: summary: Default customers_getRelationships 429 response x-microcks-default: true value: Message: string RequestId: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 Details: string '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' examples: CustomersGetRelationships500Example: summary: Default customers_getRelationships 500 response x-microcks-default: true value: Message: string RequestId: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 Details: string x-restricted: true x-microcks-operation: delay: 0 dispatcher: FALLBACK components: schemas: ReservationPersonCount: title: Age category parameters required: - AgeCategoryId - Count type: object properties: AgeCategoryId: type: string description: Unique identifier of the [Age category](https://mews-systems.gitbook.io/connector-api/operations/agecategories#age-category). format: uuid example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 Count: type: integer description: Number of people of a given age category. Only positive value is accepted. format: int32 example: 1 additionalProperties: false x-schema-id: ReservationPersonCount Unit: type: object additionalProperties: false CustomerFilterParameters: title: CustomerFilterParameters required: - AccessToken - Client - ClientToken - Extent - Limitation type: object properties: ClientToken: minLength: 1 type: string description: Token identifying the client application. example: string AccessToken: minLength: 1 type: string description: Access token of the client application. example: string Client: minLength: 1 type: string description: Name and version of the client application. example: string ChainIds: maxItems: 1000 minItems: 1 type: array items: type: string format: uuid description: Unique identifiers of the chains. Required when using Portfolio Access Tokens, ignored otherwise. nullable: true CreatedUtc: title: Time interval allOf: - $ref: '#/components/schemas/TimeFilterInterval' description: Interval in which Customer was created. nullable: true x-max-interval-in-months: 3 example: string UpdatedUtc: title: Time interval allOf: - $ref: '#/components/schemas/TimeFilterInterval' description: Interval in which Customer was updated. nullable: true x-max-interval-in-months: 3 example: string Extent: title: Customer extent allOf: - $ref: '#/components/schemas/CustomerExtent' description: Extent of data to be returned. example: string DeletedUtc: title: Time interval allOf: - $ref: '#/components/schemas/TimeFilterInterval' description: Interval in which Customer was deleted. `ActivityStates` value `Deleted` should be provided with this filter to get expected results. nullable: true x-max-interval-in-months: 3 example: string ActivityStates: type: array items: $ref: '#/components/schemas/ActivityStates' description: Whether to return only active, only deleted or both records. nullable: true CustomerIds: maxItems: 1000 minItems: 1 type: array items: type: string format: uuid description: Unique identifiers of Customers. Required if no other filter is provided. nullable: true CompanyIds: maxItems: 1 minItems: 1 type: array items: type: string format: uuid description: Unique identifier of the Company the customer is associated with. nullable: true Emails: maxItems: 1000 minItems: 1 type: array items: type: string description: Emails of the [Customers](https://mews-systems.gitbook.io/connector-api/operations/#customer). nullable: true FirstNames: maxItems: 1000 minItems: 1 type: array items: type: string description: First names of the [Customers](https://mews-systems.gitbook.io/connector-api/operations/#customer). nullable: true LastNames: maxItems: 1000 minItems: 1 type: array items: type: string description: Last names of the [Customers](https://mews-systems.gitbook.io/connector-api/operations/#customer). nullable: true LoyaltyCodes: maxItems: 1000 minItems: 1 type: array items: type: string description: Loyalty codes of the [Customers](https://mews-systems.gitbook.io/connector-api/operations/#customer). nullable: true Limitation: allOf: - $ref: '#/components/schemas/Limitation' description: Limitation on the quantity of data returned. example: string additionalProperties: false x-schema-id: CustomerFilterParameters CustomerAddFileResult: title: CustomerAddFileResult required: - FileId type: object properties: FileId: type: string description: Unique identifier of the uploaded file. format: uuid example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 additionalProperties: false x-schema-id: CustomerAddFileResult SexEnum: title: Sex enum: - Male - Female type: string description: ' Male Female' x-enumNames: - Male - Female x-enumDescriptions: - '' - '' ProductOrderItemData: title: Product order item data required: - ProductId type: object properties: ProductId: type: string description: Unique identifier of the `Product`. format: uuid example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 AgeCategoryId: type: string description: Unique identifier of the `AgeCategory`. format: uuid nullable: true example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 additionalProperties: false x-schema-id: ProductOrderItemData CustomerSearchResult: title: CustomerSearchResult required: - Customers type: object properties: Customers: type: array items: $ref: '#/components/schemas/ChargeableCustomer' description: The customer search results. Documents: type: array items: $ref: '#/components/schemas/IdentityDocument' description: The identity documents of customers. nullable: true deprecated: true x-deprecatedMessage: Use [Get all identity documents](https://mews-systems.gitbook.io/connector-api/operations/identitydocuments#get-all-identity-documents) to fetch identity documents. additionalProperties: false x-schema-id: CustomerSearchResult CustomerSearchParameters: title: CustomerSearchParameters required: - AccessToken - Client - ClientToken type: object properties: ClientToken: minLength: 1 type: string description: Token identifying the client application. example: string AccessToken: minLength: 1 type: string description: Access token of the client application. example: string Client: minLength: 1 type: string description: Name and version of the client application. example: string Name: type: string description: Name to search by (applies to first name, last name, and full name). nullable: true example: Example Name ResourceId: type: string description: Identifier of [Resource](https://mews-systems.gitbook.io/connector-api/operations/resources/#resource) to search by (members of reservation assigned there will be returned). format: uuid nullable: true example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 Extent: title: Customer extent allOf: - $ref: '#/components/schemas/CustomerExtent' description: Extent of data to be returned. nullable: true example: string additionalProperties: false x-schema-id: CustomerSearchParameters Amount: title: Amount required: - Breakdown - Currency - GrossValue - NetValue - TaxValues type: object properties: Currency: minLength: 1 type: string description: ISO-4217 code of the [Currency](https://mews-systems.gitbook.io/connector-api/operations/currencies/#currency). format: currency example: EUR NetValue: type: number description: Net value without taxes. format: double example: 100.0 GrossValue: type: number description: Gross value including all taxes. format: double example: 100.0 TaxValues: type: array items: $ref: '#/components/schemas/TaxValue' description: The tax values applied. Breakdown: title: Tax breakdown allOf: - $ref: '#/components/schemas/TaxBreakdown' description: Information about individual tax amounts. example: string additionalProperties: false description: '' x-schema-id: Amount PaymentType: title: Payment item data discriminator enum: - CreditCard - Invoice - Cash - Unspecified - BadDebts - WireTransfer - ExchangeRateDifference - ExchangeRoundingDifference - BankCharges - Cheque - Other type: string x-enumDescriptions: - '[Credit card payment item data](https://mews-systems.gitbook.io/connector-api/operations/accountingitems#credit-card-payment-item-data)' - '[Invoice payment item data](https://mews-systems.gitbook.io/connector-api/operations/accountingitems#invoice-payment-item-data)' - No additional data. - No additional data. - No additional data. - No additional data. - No additional data. - No additional data. - No additional data. - No additional data. - No additional data. CustomerItemResult: title: CustomerItemResult type: object properties: Customers: type: array items: $ref: '#/components/schemas/CustomerItems' description: The customers with their items. nullable: true additionalProperties: false x-schema-id: CustomerItemResult IdentityDocumentTypeEnum: title: Document type enum: - IdentityCard - Passport - Visa - DriversLicense type: string description: ' IdentityCard Passport Visa DriversLicense' x-enumNames: - IdentityCard - Passport - Visa - DriversLicense x-enumDescriptions: - '' - '' - '' - '' AddressParameters: title: Address parameters type: object properties: Line1: type: string description: First line of the address. nullable: true example: string Line2: type: string description: Second line of the address. nullable: true example: string City: type: string description: The city. nullable: true example: string PostalCode: type: string description: Postal code. format: postal-code nullable: true example: string CountryCode: type: string description: ISO 3166-1 code of the Country. nullable: true example: string CountrySubdivisionCode: type: string description: ISO 3166-2 code of the administrative division, e.g. DE-BW nullable: true example: string additionalProperties: false description: New address details. x-schema-id: AddressParameters TimeFilterInterval: title: Time interval type: object properties: StartUtc: type: string format: date-time nullable: true example: '2026-06-02T14:30:00Z' EndUtc: type: string format: date-time nullable: true example: '2026-06-02T14:30:00Z' additionalProperties: false description: "When a time interval is used for **filtering** (for example in parameters such as `CreatedUtc.StartUtc` / `CreatedUtc.EndUtc`), the following rules apply:\r\n\r\n- **Start equals End (equality mode)** \r\n If `StartUtc` and `EndUtc` are exactly the same timestamp, the filter is treated as an equality check for that precise moment in time:\r\n \r\n ```\r\n CreatedUtc == StartUtc\r\n ```\r\n \r\n This does not represent an interval; only records with `CreatedUtc` equal to that exact instant are returned.\r\n\r\n- **Start differs from End (interval mode)** \r\n If `StartUtc` and `EndUtc` are different, the filter is evaluated as a half-open interval:\r\n \r\n ```\r\n StartUtc <= CreatedUtc < EndUtc\r\n ```\r\n \r\n In other words, the start is inclusive and the end is exclusive.\r\n\r\nMake sure your integration takes inclusive Start / exclusive End behavior of time intervals into account so that no records at the boundaries are omitted." x-schema-id: TimeFilterInterval CustomerRelationshipFilterParameters: title: CustomerRelationshipFilterParameters required: - AccessToken - Client - ClientToken - CustomerIds - Limitation type: object properties: ClientToken: minLength: 1 type: string description: Token identifying the client application. example: string AccessToken: minLength: 1 type: string description: Access token of the client application. example: string Client: minLength: 1 type: string description: Name and version of the client application. example: string Limitation: allOf: - $ref: '#/components/schemas/Limitation' description: Limitation on the quantity of data returned and optional Cursor for the starting point of data. example: string ChainIds: maxItems: 1000 minItems: 1 type: array items: type: string format: uuid description: Unique identifiers of `Chain`. If not specified, the operation returns data for all chains within scope of the Access Token. nullable: true CustomerIds: maxItems: 100 minItems: 1 type: array items: type: string format: uuid description: Unique identifiers of `Customer`. additionalProperties: false x-schema-id: CustomerRelationshipFilterParameters Customer: title: Customer required: - ChainId - Classifications - CreatedUtc - CreatorProfileId - Id - IsActive - LastName - Number - Options - PreferredSpaceFeatures - UpdatedUtc - UpdaterProfileId type: object properties: Id: type: string description: Unique identifier of the customer. format: uuid example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 ChainId: type: string description: Unique identifier of the chain. format: uuid example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 Number: maxLength: 19 minLength: 1 type: string description: Unique number of the customer (max 19 digits). example: '1001' Title: allOf: - $ref: '#/components/schemas/Title' description: 'Title of the customer. Mister (Mr.) Miss (Ms.) Misses (Mrs.)' nullable: true example: string Sex: allOf: - $ref: '#/components/schemas/SexEnum' description: 'Sex of the customer. Male Female' nullable: true example: string FirstName: type: string description: First name of the customer. nullable: true example: Example Name LastName: minLength: 1 type: string description: Last name of the customer. example: Example Name SecondLastName: type: string description: Second last name of the customer. nullable: true example: Example Name NationalityCode: type: string description: ISO 3166-1 code of the [Country](https://mews-systems.gitbook.io/connector-api/operations/countries/#country). nullable: true example: string PreferredLanguageCode: type: string description: 'Language and culture code of the customer''s preferred language, according to their profile. For example: `en-GB`, `fr-CA`.' nullable: true example: string LanguageCode: type: string description: Language and culture code of the customer's language, based on multiple sources. These sources include the preferred language specified in internal data based on previous bookings, and the preferred language of the customer specified in their profile. If neither of these sources are present, we use the native language based on the customer's nationality. The format is, for example, `en-US` or `fr-FR`. nullable: true example: string BirthDate: type: string description: Date of birth in ISO 8601 format. nullable: true example: string BirthCountryCode: type: string description: ISO 3166-1 alpha-2 code of the birth country. nullable: true example: string BirthCountrySubdivisionCode: type: string description: ISO 3166-2 code of the administrative division, e.g. ES-C. nullable: true example: string BirthPlace: type: string description: Place of birth. nullable: true example: string Occupation: type: string description: Occupation of the customer. nullable: true example: string Email: type: string description: Email address of the customer. nullable: true example: partner@example.com HasOtaEmail: type: boolean description: Whether the customer's email address is a temporary email address from an OTA. For more details, see the [product documentation](https://help.mews.com/s/article/how-to-maintain-ota-guest-profiles-with-verified-email-addresses-obtained-from-the-guest-portal). example: true Phone: type: string description: Phone number of the customer (possibly mobile). nullable: true example: string TaxIdentificationNumber: type: string description: Tax identification number of the customer. nullable: true example: '1001' LoyaltyCode: type: string description: Loyalty code of the customer. nullable: true example: string AccountingCode: type: string description: Accounting code of the customer. nullable: true example: string BillingCode: type: string description: Billing code of the customer. nullable: true example: string Notes: type: string description: Internal notes about the customer. nullable: true example: string CarRegistrationNumber: maxLength: 255 type: string description: Registration number of the customer's car. nullable: true example: '1001' DietaryRequirements: maxLength: 255 type: string description: Customer's dietary requirements, e.g. Vegan, Halal. nullable: true example: string CreatedUtc: minLength: 1 type: string description: Creation date and time of the customer in UTC timezone in ISO 8601 format. format: date-time example: '2026-06-02T14:30:00Z' UpdatedUtc: minLength: 1 type: string description: Last update date and time of the customer in UTC timezone in ISO 8601 format. format: date-time example: '2026-06-02T14:30:00Z' Passport: title: Identity document allOf: - $ref: '#/components/schemas/IdentityDocument' nullable: true deprecated: true x-deprecatedMessage: Use [Get all identity documents](https://mews-systems.gitbook.io/connector-api/operations/identitydocuments#get-all-identity-documents) to fetch identity documents. example: string IdentityCard: title: Identity document allOf: - $ref: '#/components/schemas/IdentityDocument' nullable: true deprecated: true x-deprecatedMessage: Use [Get all identity documents](https://mews-systems.gitbook.io/connector-api/operations/identitydocuments#get-all-identity-documents) to fetch identity documents. example: string Visa: title: Identity document allOf: - $ref: '#/components/schemas/IdentityDocument' nullable: true deprecated: true x-deprecatedMessage: Use [Get all identity documents](https://mews-systems.gitbook.io/connector-api/operations/identitydocuments#get-all-identity-documents) to fetch identity documents. example: string DriversLicense: title: Identity document allOf: - $ref: '#/components/schemas/IdentityDocument' nullable: true deprecated: true x-deprecatedMessage: Use [Get all identity documents](https://mews-systems.gitbook.io/connector-api/operations/identitydocuments#get-all-identity-documents) to fetch identity documents. example: string Address: title: Address allOf: - $ref: '#/components/schemas/OldAddress' description: '' nullable: true deprecated: true x-deprecatedMessage: Use `AddressId` instead. example: string AddressId: type: string description: Unique identifier of the `Address` of the customer. format: uuid nullable: true example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 Classifications: type: array items: $ref: '#/components/schemas/CustomerClassificationEnum' description: Classifications of the customer. Options: type: array items: $ref: '#/components/schemas/CustomerOptionsEnum' description: Options of the customer. ItalianDestinationCode: type: string description: Value of Italian destination code. nullable: true example: string ItalianFiscalCode: type: string description: Value of Italian fiscal code. nullable: true example: string ItalianLotteryCode: type: string description: Italian lottery code. nullable: true example: string CompanyId: type: string description: Unique identifier of [Company](https://mews-systems.gitbook.io/connector-api/operations/companies/#company) the customer is associated with. format: uuid nullable: true example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 MergeTargetId: type: string description: Unique identifier of the account ([Customer](https://mews-systems.gitbook.io/connector-api/operations/#customer)) to which this customer is linked. format: uuid nullable: true example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 ActivityState: type: string description: '[Activity State](https://mews-systems.gitbook.io/connector-api/operations/#activity-state) of customer record, i.e. whether active or deleted.' nullable: true deprecated: true x-deprecatedMessage: Use `IsActive` instead. example: string IsActive: type: boolean description: Whether the customer record is still active. example: true PreferredSpaceFeatures: type: array items: $ref: '#/components/schemas/ResourceFeatureClassification' description: A list of room preferences, such as view type, bed type, and amenities. CreatorProfileId: type: string description: Unique identifier of the user who created the customer. format: uuid example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 UpdaterProfileId: type: string description: Unique identifier of the user who last updated the customer. format: uuid example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 additionalProperties: false x-schema-id: Customer CustomerAddParameters: title: CustomerAddParameters required: - AccessToken - Client - ClientToken - LastName - OverwriteExisting type: object properties: ClientToken: minLength: 1 type: string description: Token identifying the client application. example: string AccessToken: minLength: 1 type: string description: Access token of the client application. example: string Client: minLength: 1 type: string description: Name and version of the client application. example: string Title: anyOf: - $ref: '#/components/schemas/Title' description: Title prefix of the customer. nullable: true example: string FirstName: type: string description: First name of the customer. nullable: true example: Example Name LastName: minLength: 1 type: string description: Last name of the customer. example: Example Name SecondLastName: type: string description: Second last name of the customer. nullable: true example: Example Name NationalityCode: type: string description: ISO 3166-1 code of the `Country`. nullable: true example: string PreferredLanguageCode: type: string description: 'Language and culture code of the customer''s preferred language, according to their profile. For example: `en-GB`, `fr-CA`.' nullable: true example: string Sex: anyOf: - $ref: '#/components/schemas/Sex' description: Sex of the customer. nullable: true example: string BirthDate: type: string description: Date of birth in ISO 8601 format. format: date nullable: true example: '2026-06-02' BirthCountryCode: type: string description: Country of birth. nullable: true example: string BirthCountrySubdivisionCode: type: string description: Province of birth. nullable: true example: string BirthPlace: type: string description: Place of birth. nullable: true example: string Occupation: type: string description: Occupation of the customer. nullable: true example: string Email: type: string description: Email address of the customer. format: email nullable: true example: partner@example.com Phone: type: string description: Phone number of the customer (possibly mobile). format: tel nullable: true example: string LoyaltyCode: type: string description: Loyalty code of the customer. nullable: true example: string Notes: type: string description: Internal notes about the customer. nullable: true example: string CarRegistrationNumber: maxLength: 255 type: string description: Registration number of the customer's car. nullable: true example: '1001' DietaryRequirements: maxLength: 255 type: string description: Customer's dietary requirements, e.g. Vegan, Halal. nullable: true example: string TaxIdentificationNumber: type: string description: Tax identification number of the customer. nullable: true example: '1001' CompanyId: type: string description: Unique identifier of `Company` the customer is associated with. format: uuid nullable: true example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 Address: title: Address parameters allOf: - $ref: '#/components/schemas/AddressParameters' description: Address of the customer. nullable: true example: string IdentityCard: title: Identity document parameters allOf: - $ref: '#/components/schemas/DocumentParameters' description: Identity card details of the customer. nullable: true deprecated: true x-deprecatedMessage: Use [Add identity documents](https://mews-systems.gitbook.io/connector-api/operations/identitydocuments#add-identity-documents) to add document. example: string Passport: title: Identity document parameters allOf: - $ref: '#/components/schemas/DocumentParameters' description: Passport details of the customer. nullable: true deprecated: true x-deprecatedMessage: Use [Add identity documents](https://mews-systems.gitbook.io/connector-api/operations/identitydocuments#add-identity-documents) to add document. example: string Visa: title: Identity document parameters allOf: - $ref: '#/components/schemas/DocumentParameters' description: Visa details of the customer. nullable: true deprecated: true x-deprecatedMessage: Use [Add identity documents](https://mews-systems.gitbook.io/connector-api/operations/identitydocuments#add-identity-documents) to add document. example: string DriversLicense: title: Identity document parameters allOf: - $ref: '#/components/schemas/DocumentParameters' description: Drivers license details of the customer. nullable: true deprecated: true x-deprecatedMessage: Use [Add identity documents](https://mews-systems.gitbook.io/connector-api/operations/identitydocuments#add-identity-documents) to add document. example: string Classifications: uniqueItems: true type: array items: $ref: '#/components/schemas/CustomerClassificationEnum' description: Classifications of the customer. nullable: true Options: uniqueItems: true type: array items: $ref: '#/components/schemas/CustomerOptionEnum' description: Options of the customer. nullable: true ChainId: type: string description: Unique identifier of the chain. Required when using `PortfolioAccessTokens`, ignored otherwise. format: uuid nullable: true example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 OverwriteExisting: type: boolean description: Whether an existing customer should be overwritten in case of duplicity. This applies only to basic personal information (`Title`, `FirstName`, `LastName`, ...). example: true ItalianDestinationCode: type: string description: Value of Italian destination code. nullable: true example: string ItalianFiscalCode: type: string description: Value of Italian fiscal code. nullable: true example: string ItalianLotteryCode: maxLength: 15 minLength: 2 type: string description: Value of Italian lottery code. nullable: true example: string additionalProperties: false x-schema-id: CustomerAddParameters RebateOrderItemData: title: Rebate order item data required: - RebatedItemId type: object properties: RebatedItemId: type: string description: Unique identifier of `OrderItem` which has been rebated by current item. format: uuid example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 additionalProperties: false x-schema-id: RebateOrderItemData CustomerRelationshipResult: title: CustomerRelationshipResult required: - CustomerRelationships type: object properties: CustomerRelationships: type: array items: $ref: '#/components/schemas/CustomerRelationship' description: The relationships for the customers. Cursor: type: string description: Unique identifier of the item one newer in time order than the items to be returned. If Cursor is not specified, i.e. null, then the latest or most recent items will be returned. format: uuid nullable: true example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 additionalProperties: false x-schema-id: CustomerRelationshipResult Sex: title: Sex enum: - Male - Female type: string ActivityStates: title: Activity state enum: - Deleted - Active type: string description: Activity states used for filtering. CustomerOptionsEnum: title: Customer option enum: - None - SendMarketingEmails - Invoiceable - BillAddressObjection - SendMarketingPostalMail - SendPartnerMarketingEmails - SendPartnerMarketingPostalMail - WithdrawCardConsent - GuestPhotoConsent - IdPhotosConsent type: string description: ' None SendMarketingEmails Invoiceable BillAddressObjection SendMarketingPostalMail SendPartnerMarketingEmails SendPartnerMarketingPostalMail WithdrawCardConsent GuestPhotoConsent IdPhotosConsent' x-enumNames: - None - SendMarketingEmails - Invoiceable - BillAddressObjection - SendMarketingPostalMail - SendPartnerMarketingEmails - SendPartnerMarketingPostalMail - WithdrawCardConsent - GuestPhotoConsent - IdPhotosConsent x-enumDescriptions: - '' - '' - '' - '' - '' - '' - '' - '' - '' - '' ResourceFeatureClassification: title: Resource feature classification enum: - SeaView - RiverView - OceanView - TwinBeds - DoubleBed - RollawayBed - UpperBed - LowerBed - Balcony - AccessibleBathroom - AccessibleRoom - ElevatorAccess - HighFloor - Kitchenette - AirConditioning - PrivateJacuzzi - PrivateSauna - EnsuiteRoom - PrivateBathroom - SharedBathroom type: string description: Classification of `ResourceFeature`. CustomerItems: title: Customer items required: - CustomerId - Items - OrderItems - PaymentItems type: object properties: CustomerId: type: string description: Unique identifier of the `Customer`. format: uuid example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 Items: type: array items: $ref: '#/components/schemas/AccountingItem' deprecated: true x-deprecatedMessage: Use `OrderItems` and `PaymentItems` instead. OrderItems: type: array items: $ref: '#/components/schemas/OrderItemOld' description: The open order items (consumed items such as nights or products). PaymentItems: type: array items: $ref: '#/components/schemas/PaymentItemOld' description: The open payment items (such as cash, credit card payments or invoices). additionalProperties: false x-schema-id: CustomerItems CustomerFileParameters: title: CustomerFileParameters required: - AccessToken - Client - ClientToken - CustomerId - Data - Name - Type type: object properties: ClientToken: minLength: 1 type: string description: Token identifying the client application. example: string AccessToken: minLength: 1 type: string description: Access token of the client application. example: string Client: minLength: 1 type: string description: Name and version of the client application. example: string ChainId: type: string description: Unique identifier of the chain. Required when using [Portfolio Access Tokens](https://mews-systems.gitbook.io/connector-api/concepts/multi-property), ignored otherwise. format: uuid nullable: true example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 CustomerId: type: string description: Unique identifier of the [Customer](https://mews-systems.gitbook.io/connector-api/operations/#customer). format: uuid example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 Name: minLength: 1 type: string description: Name of the file. example: Example Name Type: minLength: 1 type: string description: MIME type of the file (e.g. `application/pdf`). example: string Data: minLength: 1 type: string description: Base64-encoded data of the file. example: string additionalProperties: false x-schema-id: CustomerFileParameters PaymentItemOld: title: Payment item required: - AccountId - AccountingState - Amount - ConsumedUtc - Data - Id - OriginalAmount - State type: object properties: Id: type: string description: Unique identifier of the item. format: uuid example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 AccountId: type: string description: Unique identifier of the account (for example `Customer`) the item belongs to. format: uuid example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 BillId: type: string description: Unique identifier of the `Bill` the item is assigned to. format: uuid nullable: true example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 AccountingCategoryId: type: string description: Unique identifier of the `AccountingCategory` the item belongs to. format: uuid nullable: true example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 Amount: title: Extended amount allOf: - $ref: '#/components/schemas/ExtendedAmount' description: Item's amount, negative amount represents either rebate or a payment. example: string OriginalAmount: title: Extended amount allOf: - $ref: '#/components/schemas/ExtendedAmount' description: Amount of item; note a negative amount represents a rebate or payment. Contains the earliest known value in conversion chain. example: string AmountDefault: title: Extended amount allOf: - $ref: '#/components/schemas/ExtendedAmount' description: Item's amount in property's default currency, negative amount represents either rebate or a payment. nullable: true deprecated: true example: string Notes: type: string description: Additional notes. nullable: true example: string SettlementId: type: string description: Identifier of the settled payment from the external system (ApplePay/GooglePay). nullable: true example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 ConsumedUtc: minLength: 1 type: string description: Date and time of the item consumption in UTC timezone in ISO 8601 format. example: string ClosedUtc: type: string description: Date and time of the item bill closure in UTC timezone in ISO 8601 format. nullable: true example: string AccountingState: minLength: 1 type: string description: Accounting state of the item. example: string State: minLength: 1 type: string description: Payment state of the item. example: string Identifier: type: string description: External payment identifier. nullable: true example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 Data: title: Payment item data type: object properties: Discriminator: $ref: '#/components/schemas/PaymentType' Value: oneOf: - $ref: '#/components/schemas/PaymentCardPaymentData' - $ref: '#/components/schemas/InvoicePaymentData' description: Based on payment item data discriminator or `null` for types without any additional data. nullable: true description: Additional data specific to particular payment item. x-coproduct: true x-schema-id: PaymentItemOldDataCoproductOfPaymentType additionalProperties: false description: '' x-schema-id: PaymentItemOld CustomerOptionEnum: title: Customer option enum: - SendMarketingEmails - Invoiceable - BillAddressObjection - SendMarketingPostalMail - SendPartnerMarketingEmails - SendPartnerMarketingPostalMail - WithdrawCardConsent - GuestPhotoConsent - IdPhotosConsent type: string description: ' SendMarketingEmails Invoiceable BillAddressObjection SendMarketingPostalMail SendPartnerMarketingEmails SendPartnerMarketingPostalMail WithdrawCardConsent GuestPhotoConsent (Whether to ask for consent to take a guest photo.) IdPhotosConsent (Whether to ask for consent to take identity document photos.)' x-enumNames: - SendMarketingEmails - Invoiceable - BillAddressObjection - SendMarketingPostalMail - SendPartnerMarketingEmails - SendPartnerMarketingPostalMail - WithdrawCardConsent - GuestPhotoConsent - IdPhotosConsent x-enumDescriptions: - '' - '' - '' - '' - '' - '' - '' - Whether to ask for consent to take a guest photo. - Whether to ask for consent to take identity document photos. TaxBreakdownItem: title: Tax breakdown item required: - NetValue - TaxValue type: object properties: TaxRateCode: type: string description: Tax rate code for the item. `null` for untaxed amounts. nullable: true example: string NetValue: type: number description: The net value that the tax is calculated from. format: double example: 100.0 TaxValue: type: number description: The value of the tax. format: double example: 100.0 additionalProperties: false x-schema-id: TaxBreakdownItem PaymentCardPaymentData: title: Credit card payment item data type: object properties: PaymentCardId: type: string description: Unique identifier of the `CreditCard`. format: uuid nullable: true example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 additionalProperties: false x-schema-id: PaymentCardPaymentData InvoicePaymentData: title: Invoice payment item data required: - InvoiceId type: object properties: InvoiceId: type: string description: Unique identifier of the invoice `Bill`. format: uuid example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 additionalProperties: false x-schema-id: InvoicePaymentData OrderItemTypeOld: title: Order item data discriminator enum: - CancellationFee - Rebate - Deposit - ExchangeRateDifference - CustomItem - Surcharge - SurchargeDiscount - SpaceOrder - ProductOrder - Other - TaxCorrection - ResourceUpgradeFee - InvoiceFee type: string x-enumDescriptions: - No additional data. - '[Rebate order item data](https://mews-systems.gitbook.io/connector-api/operations/accountingitems#rebate-order-item-data)' - No additional data. - No additional data. - No additional data. - No additional data. - No additional data. - No additional data. - '[Product order item data](https://mews-systems.gitbook.io/connector-api/operations/accountingitems#product-order-item-data)' - No additional data. - No additional data. - No additional data. - No additional data. IdentityDocument: title: Identity document type: object properties: Id: type: string description: Unique identifier of the document. format: uuid example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 CustomerId: type: string description: Identifier of the `Customer`. format: uuid example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 Type: title: Document type allOf: - $ref: '#/components/schemas/IdentityDocumentTypeEnum' description: 'Type of the document. IdentityCard Passport Visa DriversLicense' x-enumNames: - IdentityCard - Passport - Visa - DriversLicense x-enumDescriptions: - '' - '' - '' - '' example: string Number: type: string description: Number of the document (e.g. passport number). nullable: true example: '1001' Expiration: type: string description: Expiration date in ISO 8601 format. format: date nullable: true example: '2026-06-02' Issuance: type: string description: Date of issuance in ISO 8601 format. format: date nullable: true example: '2026-06-02' IssuingCountryCode: type: string description: ISO 3166-1 code of the `Country`. nullable: true example: string IssuingCountrySubdivisionCode: type: string description: Identifier of the country subdivision where the document was issued (province, state or region). nullable: true example: string IssuingCity: type: string description: City where the document was issued. nullable: true example: string IdentityDocumentSupportNumber: type: string description: Identity document support number. Only required for Spanish identity cards in Spanish hotels. nullable: true example: '1001' additionalProperties: false x-schema-id: IdentityDocument OrderItemOld: title: Order item required: - AccountId - AccountingState - Amount - CreatedUtc - CreatorProfileId - Data - Id - OrderId - OriginalAmount - RevenueType - UnitAmount - UpdatedUtc - UpdaterProfileId type: object properties: Id: type: string description: Unique identifier of the item. format: uuid example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 AccountId: type: string description: Unique identifier of the account (for example `Customer`) the item belongs to. format: uuid example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 OrderId: type: string description: Unique identifier of the order (or `Reservation` which is a special type of order) the item belongs to. format: uuid example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 BillId: type: string description: Unique identifier of the `Bill` the item is assigned to. format: uuid nullable: true example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 AccountingCategoryId: type: string description: Unique identifier of the `AccountingCategory` the item belongs to. format: uuid nullable: true example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 UnitCount: type: integer description: Unit count of item, i.e. the number of sub-items or units, if applicable. format: int32 example: 1 UnitAmount: title: Amount allOf: - $ref: '#/components/schemas/Amount' description: Unit amount of item, i.e. the amount of each individual sub-item or unit, if applicable. example: string Amount: title: Extended amount allOf: - $ref: '#/components/schemas/ExtendedAmount' description: Amount of item; note a negative amount represents a rebate or payment. example: string OriginalAmount: title: Extended amount allOf: - $ref: '#/components/schemas/ExtendedAmount' description: Amount of item; note a negative amount represents a rebate or payment. Contains the earliest known value in conversion chain. example: string RevenueType: minLength: 1 type: string description: Revenue type of the item. example: string CreatorProfileId: type: string description: Unique identifier of the user who created the item. format: uuid example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 UpdaterProfileId: type: string description: Unique identifier of the user who updated the item. format: uuid example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 CreatedUtc: minLength: 1 type: string description: Creation date and time of the item in UTC timezone in ISO 8601 format. format: date example: '2026-06-02' UpdatedUtc: minLength: 1 type: string description: Last update date and time of the item in UTC timezone in ISO 8601 format. format: date example: '2026-06-02' ConsumedUtc: type: string description: Date and time of the item consumption in UTC timezone in ISO 8601 format. format: date nullable: true example: '2026-06-02' CanceledUtc: type: string description: Cancellation date and time of the item in UTC timezone in ISO 8601 format. format: date nullable: true example: '2026-06-02' ClosedUtc: type: string description: Date and time of the item bill closure in UTC timezone in ISO 8601 format. format: date nullable: true example: '2026-06-02' StartUtc: type: string description: Start date and time of the item in UTC timezone in ISO 8601 format. format: date nullable: true example: '2026-06-02' AccountingState: minLength: 1 type: string description: Accounting state of the item. example: string Data: title: Order item data type: object properties: Discriminator: $ref: '#/components/schemas/OrderItemTypeOld' Value: oneOf: - $ref: '#/components/schemas/RebateOrderItemData' - $ref: '#/components/schemas/ProductOrderItemData' description: Based on order item discriminator or `null` for types without any additional data. nullable: true description: Additional data specific to particular order item. x-coproduct: true x-schema-id: OrderItemOldDataCoproductOfOrderItemTypeOld additionalProperties: false x-schema-id: OrderItemOld TaxValue: title: Tax value required: - Value type: object properties: Code: type: string description: Code corresponding to tax type. nullable: true example: string Value: type: number description: Amount of tax applied. format: double example: 100.0 additionalProperties: false x-schema-id: TaxValue CustomerMergeParameters: title: CustomerMergeParameters required: - AccessToken - Client - ClientToken - SourceCustomerId - TargetCustomerId type: object properties: ClientToken: minLength: 1 type: string description: Token identifying the client application. example: string AccessToken: minLength: 1 type: string description: Access token of the client application. example: string Client: minLength: 1 type: string description: Name and version of the client application. example: string SourceCustomerId: type: string description: Unique identifier of the source [Customer](https://mews-systems.gitbook.io/connector-api/operations/#customer). format: uuid example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 TargetCustomerId: type: string description: Unique identifier of the target [Customer](https://mews-systems.gitbook.io/connector-api/operations/#customer). format: uuid example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 additionalProperties: false x-schema-id: CustomerMergeParameters CustomerItemParameters: title: CustomerItemParameters required: - AccessToken - Client - ClientToken - CustomerIds type: object properties: ClientToken: minLength: 1 type: string description: Token identifying the client application. example: string AccessToken: minLength: 1 type: string description: Access token of the client application. example: string Client: minLength: 1 type: string description: Name and version of the client application. example: string CustomerIds: maxItems: 1000 minItems: 1 type: array items: type: string format: uuid description: Unique identifiers of `Customer`. Currency: type: string description: ISO-4217 code of the [Currency](https://mews-systems.gitbook.io/connector-api/operations/currencies/#currency) the item costs should be converted to. format: date-time nullable: true example: '2026-06-02T14:30:00Z' additionalProperties: false x-schema-id: CustomerItemParameters TaxBreakdown: title: Tax breakdown required: - Items type: object properties: Items: type: array items: $ref: '#/components/schemas/TaxBreakdownItem' description: Tax breakdown items per each tax rate applied. additionalProperties: false x-schema-id: TaxBreakdown OldAddress: title: Address type: object properties: Id: type: string description: Unique identifier of the address. format: uuid example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 Line1: type: string description: First line of the address. nullable: true example: string Line2: type: string description: Second line of the address. nullable: true example: string City: type: string description: The city. nullable: true example: string PostalCode: type: string description: Postal code. nullable: true example: string CountryCode: type: string description: ISO 3166-1 code of the `Country`. nullable: true example: string CountrySubdivisionCode: type: string description: ISO 3166-2 code of the administrative division, e.g. `DE-BW`. nullable: true example: string Latitude: type: number description: The latitude. format: double nullable: true example: 100.0 Longitude: type: number description: The longitude. format: double nullable: true example: 100.0 additionalProperties: false description: '' x-schema-id: OldAddress ChargeableCustomer: title: Customer search result required: - Customer type: object properties: Customer: allOf: - $ref: '#/components/schemas/Customer' description: The found customer. example: string Reservation: title: Reservation (ver 2017-04-12) allOf: - $ref: '#/components/schemas/ReservationOld' description: Reservation of the customer in case they are currently staying in the property. nullable: true example: string additionalProperties: false x-schema-id: ChargeableCustomer ReservationOptions: title: Reservation options required: - AllCompanionsCheckedIn - AnyCompanionCheckedIn - OwnerCheckedIn type: object properties: OwnerCheckedIn: type: boolean description: Owner of the reservation checked in. example: true AllCompanionsCheckedIn: type: boolean description: All companions of the reservation checked in. example: true AnyCompanionCheckedIn: type: boolean description: Any companion of the reservation checked in. example: true additionalProperties: false x-schema-id: ReservationOptions CustomerUpdateParameters: title: CustomerUpdateParameters required: - AccessToken - Client - ClientToken - CustomerId type: object properties: ClientToken: minLength: 1 type: string description: Token identifying the client application. example: string AccessToken: minLength: 1 type: string description: Access token of the client application. example: string Client: minLength: 1 type: string description: Name and version of the client application. example: string ChainId: type: string description: Unique identifier of the chain. Required when using `PortfolioAccessTokens`, ignored otherwise. format: uuid nullable: true example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 CustomerId: type: string description: Unique identifier of the `Customer` to be updated. format: uuid example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 Title: allOf: - $ref: '#/components/schemas/Title' description: 'New title. Mister (Mr.) Miss (Ms.) Misses (Mrs.)' nullable: true example: string FirstName: type: string description: New first name. nullable: true example: Example Name LastName: type: string description: New last name. nullable: true example: Example Name SecondLastName: type: string description: New second last name. nullable: true example: Example Name NationalityCode: type: string description: New nationality code as ISO 3166-1 code of the `Country`. nullable: true example: string PreferredLanguageCode: type: string description: 'Language and culture code of the customer''s preferred language, according to their profile. For example: `en-GB`, `fr-CA`.' nullable: true example: string Sex: allOf: - $ref: '#/components/schemas/SexEnum' description: 'Sex of the customer. Male Female' nullable: true example: string BirthDate: type: string description: New birth date in ISO 8601 format. format: date nullable: true example: '2026-06-02' BirthCountryCode: type: string description: Country of birth. nullable: true example: string BirthCountrySubdivisionCode: type: string description: Province of birth. nullable: true example: string BirthPlace: type: string description: New birth place. nullable: true example: string Occupation: type: string description: Occupation of the customer. nullable: true example: string Email: type: string description: New email address. format: email nullable: true example: partner@example.com Phone: type: string description: New phone number. format: tel nullable: true example: string LoyaltyCode: type: string description: Loyalty code of the customer. nullable: true example: string Notes: type: string description: Internal notes about the customer. Old value will be overwritten. nullable: true example: string CarRegistrationNumber: maxLength: 255 type: string description: New registration number of the customer's car. nullable: true example: '1001' DietaryRequirements: maxLength: 255 type: string description: Customer's dietary requirements, e.g. Vegan, Halal. nullable: true example: string TaxIdentificationNumber: type: string description: New tax identification number of the customer. nullable: true example: '1001' CompanyId: type: string description: Unique identifier of `Company` the customer is associated with. format: uuid nullable: true example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 Address: title: Address parameters allOf: - $ref: '#/components/schemas/AddressParameters' description: New address details. nullable: true example: string IdentityCard: title: Identity document parameters allOf: - $ref: '#/components/schemas/DocumentParameters' description: New identity card details. nullable: true deprecated: true x-deprecatedMessage: Use [Update identity documents](https://mews-systems.gitbook.io/connector-api/operations/identitydocuments#update-identity-documents) to update document. example: string Passport: title: Identity document parameters allOf: - $ref: '#/components/schemas/DocumentParameters' description: New passport details. nullable: true deprecated: true x-deprecatedMessage: Use [Update identity documents](https://mews-systems.gitbook.io/connector-api/operations/identitydocuments#update-identity-documents) to update document. example: string Visa: title: Identity document parameters allOf: - $ref: '#/components/schemas/DocumentParameters' description: New visa details. nullable: true deprecated: true x-deprecatedMessage: Use [Update identity documents](https://mews-systems.gitbook.io/connector-api/operations/identitydocuments#update-identity-documents) to update document. example: string DriversLicense: title: Identity document parameters allOf: - $ref: '#/components/schemas/DocumentParameters' description: New drivers license details. nullable: true deprecated: true x-deprecatedMessage: Use [Update identity documents](https://mews-systems.gitbook.io/connector-api/operations/identitydocuments#update-identity-documents) to update document. example: string Classifications: uniqueItems: true type: array items: $ref: '#/components/schemas/CustomerClassificationEnum' description: New classifications of the customer. nullable: true Options: uniqueItems: true type: array items: $ref: '#/components/schemas/CustomerOptionEnum' description: Options of the customer. nullable: true ItalianDestinationCode: title: String update value allOf: - $ref: '#/components/schemas/StringUpdateValue' description: New Italian destination code of customer. nullable: true example: string ItalianFiscalCode: title: String update value allOf: - $ref: '#/components/schemas/StringUpdateValue' description: New Italian fiscal code of customer. nullable: true example: string ItalianLotteryCode: title: String update value maxLength: 15 minLength: 2 allOf: - $ref: '#/components/schemas/StringUpdateValue' description: New Italian lottery code of customer. nullable: true example: string additionalProperties: false x-schema-id: CustomerUpdateParameters Title: title: Title enum: - Mister - Miss - Misses type: string description: "Type of the title prefix of the customer.\r\n\r\nNote that the value should not be used as-is, but localized. For example, the value `Misses` should be displayed as `Mrs.` in English and `Fr.` in German.\n\nMister (Mr.)\n\nMiss (Ms.)\n\nMisses (Mrs.)" x-enumNames: - Mister - Miss - Misses x-enumDescriptions: - Mr. - Ms. - Mrs. x-schema-id: Title x-showDescription: true CustomerExtent: title: Customer extent type: object properties: Customers: type: boolean description: Whether the response should contain information about customers. nullable: true example: true Documents: type: boolean description: Whether the response should contain identity documents of customers. nullable: true deprecated: true x-deprecatedMessage: Use [Get all identity documents](https://mews-systems.gitbook.io/connector-api/operations/identitydocuments#get-all-identity-documents) instead. example: true Addresses: type: boolean description: Whether the response should contain addresses of customers. nullable: true example: true additionalProperties: false description: '' x-schema-id: CustomerExtent AccountingItem: title: Accounting item type: object properties: Id: type: string format: uuid example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 AccountId: type: string format: uuid example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 CustomerId: type: string format: uuid nullable: true deprecated: true x-deprecatedMessage: Use `AccountId` instead. example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 OrderId: type: string format: uuid nullable: true example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 ServiceId: type: string format: uuid nullable: true example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 ProductId: type: string format: uuid nullable: true example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 BillId: type: string format: uuid nullable: true example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 InvoiceId: type: string format: uuid nullable: true example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 AccountingCategoryId: type: string format: uuid nullable: true example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 CreditCardId: type: string format: uuid nullable: true example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 Type: type: string nullable: true example: string SubType: type: string nullable: true example: string Name: type: string nullable: true example: Example Name Notes: type: string nullable: true example: string ConsumptionUtc: type: string nullable: true example: string ClosedUtc: type: string nullable: true example: string State: type: string nullable: true example: string SubState: type: string nullable: true example: string Amount: title: Extended amount allOf: - $ref: '#/components/schemas/ExtendedAmount' description: '' nullable: true example: string TaxExemptionReasonCode: type: string description: Code of tax exemption reason. **Restricted!** This property is currently intended for Mews' internal usage and may be subject to change. nullable: true example: string additionalProperties: false x-schema-id: AccountingItem ReservationOldOrigin: title: Reservation origin (ver 2017-04-12) enum: - Distributor - ChannelManager - Import - Connector - Navigator - CommanderInPerson - CommanderChannel - CommanderPhone - CommanderEmail - CommanderWebsite - CommanderMessage - CommanderCallCenter - CommanderRoomingList type: string x-enumDescriptions: - From the Mews Booking Engine or Booking Engine API. - From a channel manager. - From an import process. - From the Mews Connector API. - From Mews Guest Services. - From Mews Operations, in person. - From Mews Operations, via channel. - From Mews Operations, via telephone. - From Mews Operations, via email. - From Mews Operations, via website. - From Mews Operations, via message person. - From Mews Operations, via call center. - From Mews Operations, via rooming list. ExtendedAmount: title: Extended amount required: - Breakdown - Currency - GrossValue - NetValue - TaxValues type: object properties: Currency: minLength: 1 type: string description: ISO-4217 code of the [Currency](https://mews-systems.gitbook.io/connector-api/operations/currencies/#currency). format: currency example: EUR NetValue: type: number description: Net value without taxes. format: double example: 100.0 GrossValue: type: number description: Gross value including all taxes. format: double example: 100.0 TaxValues: type: array items: $ref: '#/components/schemas/TaxValue' description: The tax values applied. Breakdown: title: Tax breakdown allOf: - $ref: '#/components/schemas/TaxBreakdown' description: Information about individual tax amounts. example: string Value: type: number format: double nullable: true example: 100.0 Net: type: number format: double nullable: true example: 100.0 Tax: type: number format: double nullable: true example: 100.0 TaxRate: type: number format: double nullable: true example: 100.0 additionalProperties: false description: '' x-schema-id: ExtendedAmount CustomerClassificationEnum: title: Customer classification enum: - PaymasterAccount - Blacklist - Media - LoyaltyProgram - PreviousComplaint - Returning - Staff - FriendOrFamily - TopManagement - Important - VeryImportant - Problematic - Cashlist - DisabledPerson - Military - Airline - HealthCompliant - InRoom - WaitingForRoom - Student - Blocklist type: string description: ' PaymasterAccount Blacklist (Deprecated, use Blocklist instead.) Media LoyaltyProgram PreviousComplaint Returning Staff FriendOrFamily TopManagement Important VeryImportant Problematic Cashlist DisabledPerson Military Airline HealthCompliant InRoom WaitingForRoom Student Blocklist' x-enumNames: - PaymasterAccount - Blacklist - Media - LoyaltyProgram - PreviousComplaint - Returning - Staff - FriendOrFamily - TopManagement - Important - VeryImportant - Problematic - Cashlist - DisabledPerson - Military - Airline - HealthCompliant - InRoom - WaitingForRoom - Student - Blocklist x-enumDescriptions: - '' - Deprecated, use Blocklist instead. - '' - '' - '' - '' - '' - '' - '' - '' - '' - '' - '' - '' - '' - '' - '' - '' - '' - '' - '' ServiceOrderStateOld: title: Service order state (ver 2017-04-12) enum: - Enquired - Confirmed - Started - Processed - Canceled - Optional - Requested type: string CustomerResult: title: CustomerResult required: - Customers type: object properties: Customers: type: array items: $ref: '#/components/schemas/Customer' description: The customers. Documents: type: array items: $ref: '#/components/schemas/IdentityDocument' description: The identity documents of customers. nullable: true deprecated: true x-deprecatedMessage: Use [Get all identity documents](https://mews-systems.gitbook.io/connector-api/operations/identitydocuments#get-all-identity-documents) to fetch identity documents. Cursor: type: string description: Unique identifier of the last and hence oldest customer item returned. This can be used in [Limitation](https://mews-systems.gitbook.io/connector-api/guidelines/pagination/#limitation) in a subsequent request to fetch the next batch of older customers. If [Limitation](https://mews-systems.gitbook.io/connector-api/guidelines/pagination/#limitation) is specified in the request message, then Cursor will always be included in the response message; this is true even when using Extents set to false so that no actual data is returned. format: uuid nullable: true example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 additionalProperties: false x-schema-id: CustomerResult CustomerRelationshipTypeEnum: title: Customer relationship type enum: - Spouse - Child - Parent - OtherFamily - Friend - Colleague - Other type: string description: ' Spouse Child Parent OtherFamily (Any familial relationship that doesn''t fit for the options provided) Friend Colleague Other' x-enumNames: - Spouse - Child - Parent - OtherFamily - Friend - Colleague - Other x-enumDescriptions: - '' - '' - '' - Any familial relationship that doesn't fit for the options provided - '' - '' - '' x-extensible: true ConnectorApiExceptionResult: title: ConnectorApiExceptionResult type: object properties: Message: type: string nullable: true example: string RequestId: type: string nullable: true example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 Details: nullable: true example: string additionalProperties: false x-schema-id: ConnectorApiExceptionResult ReservationOld: title: Reservation (ver 2017-04-12) required: - AssignedResourceLocked - CompanionIds - CreatedUtc - CustomerId - EndUtc - GroupId - Id - Number - Options - Origin - OwnerId - PersonCounts - RateId - RequestedCategoryId - ServiceId - StartUtc - State - UpdatedUtc type: object properties: Id: type: string description: Unique identifier of the reservation. format: uuid example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 ServiceId: type: string description: Unique identifier of the Service that is reserved. format: uuid example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 GroupId: type: string description: Unique identifier of the Reservation group. format: uuid example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 Number: minLength: 1 type: string description: Confirmation number of the reservation in Mews. example: '1001' ChannelNumber: type: string description: Number of the reservation within the Channel (i.e. OTA, GDS, CRS, etc) in case the reservation group originates there (e.g. Booking.com confirmation number). nullable: true example: '1001' ChannelManagerNumber: type: string description: Unique number of the reservation within the reservation group. nullable: true example: '1001' ChannelManagerGroupNumber: type: string description: Number of the reservation group within a Channel manager that transferred the reservation from Channel to Mews. nullable: true example: '1001' ChannelManager: type: string description: Name of the Channel manager (e.g. AvailPro, SiteMinder, TravelClick, etc). nullable: true example: string State: $ref: '#/components/schemas/ServiceOrderStateOld' Origin: $ref: '#/components/schemas/ReservationOldOrigin' OriginDetails: type: string description: Details about the reservation origin. nullable: true example: string Purpose: anyOf: - $ref: '#/components/schemas/ReservationPurpose' description: Purpose of the reservation. nullable: true example: string CreatedUtc: minLength: 1 type: string description: Creation date and time of the reservation in UTC timezone in ISO 8601 format. example: string UpdatedUtc: minLength: 1 type: string description: Last update date and time of the reservation in UTC timezone in ISO 8601 format. example: string CancelledUtc: type: string description: Cancellation date and time in UTC timezone in ISO 8601 format. nullable: true example: string StartUtc: minLength: 1 type: string description: Start of the reservation in UTC timezone in ISO 8601 format. This is either the scheduled reservation start time, or the actual customer check-in time if this is earlier than the scheduled start time. example: string EndUtc: minLength: 1 type: string description: End of the reservation (departure) in UTC timezone in ISO 8601 format. example: string ReleasedUtc: type: string description: Date when the optional reservation is released in UTC timezone in ISO 8601 format. nullable: true example: string RequestedCategoryId: type: string description: Identifier of the requested Resource category. format: uuid example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 AssignedSpaceId: type: string description: Identifier of the assigned Space. format: uuid nullable: true deprecated: true x-deprecatedMessage: Use `AssignedResourceId` instead. example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 AssignedSpaceLocked: type: boolean description: Whether the reservation is locked to the assigned Space and cannot be moved. deprecated: true x-deprecatedMessage: Use `AssignedResourceLocked` instead. example: true AssignedResourceId: type: string description: Identifier of the assigned Resource. format: uuid nullable: true example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 AssignedResourceLocked: type: boolean description: Whether the reservation is locked to the assigned Resource and cannot be moved. example: true BusinessSegmentId: type: string description: Identifier of the reservation Business segment. format: uuid nullable: true example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 CompanyId: type: string description: Identifier of the Company on behalf of which the reservation was made. format: uuid nullable: true example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 TravelAgencyId: type: string description: Identifier of the Company that mediated the reservation. format: uuid nullable: true example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 AvailabilityBlockId: type: string description: Unique identifier of the Availability block the reservation is assigned to. format: uuid nullable: true example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 RateId: type: string description: Identifier of the reservation Rate. format: uuid example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 VoucherId: type: string description: Unique identifier of the Voucher that has been used to create reservation. format: uuid nullable: true example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 CreditCardId: type: string description: Unique identifier of the Credit card. format: uuid nullable: true example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 CancellationReason: anyOf: - $ref: '#/components/schemas/CancellationReason' description: Cancellation reason of the reservation. nullable: true example: string AdultCount: type: integer description: Count of adults the reservation was booked for. format: int32 deprecated: true x-deprecatedMessage: Use `PersonCounts` instead. example: 1 ChildCount: type: integer description: Count of children the reservation was booked for. format: int32 deprecated: true x-deprecatedMessage: Use `PersonCounts` instead. example: 1 PersonCounts: type: array items: $ref: '#/components/schemas/ReservationPersonCount' description: Number of people per age category the reservation was booked for. OwnerId: type: string description: Unique identifier of the Customer or Company who owns the reservation. format: uuid example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 CustomerId: type: string description: Unique identifier of the Customer who owns the reservation. format: uuid deprecated: true x-deprecatedMessage: Use `OwnerId` instead. example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 BookerId: type: string description: Unique identifier of the Customer on whose behalf the reservation was made. format: uuid nullable: true example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 CompanionIds: type: array items: type: string format: uuid description: Unique identifiers of the `Customer`s that will use the resource. deprecated: true x-deprecatedMessage: Use `companionships/getAll` instead. ChannelManagerId: type: string description: Channel Manager number. nullable: true deprecated: true x-deprecatedMessage: Use `ChannelManagerNumber` instead. example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 Options: title: Reservation options allOf: - $ref: '#/components/schemas/ReservationOptions' description: Options of the reservation. example: string additionalProperties: false description: '' x-schema-id: ReservationOld Limitation: title: Limitation required: - Count type: object properties: Count: type: integer format: int32 example: 1 Cursor: type: string format: uuid nullable: true example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 additionalProperties: false description: Limitation on the quantity of data returned. x-schema-id: Limitation CustomerRelationship: title: CustomerRelationship required: - CustomerId - RelatedCustomerId - Relationship type: object properties: CustomerId: type: string description: Unique identifier of the customer in the relationship. format: uuid example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 RelatedCustomerId: type: string description: Unique identifier of the related customer. format: uuid example: 3edd5f9e-7e64-4f2a-9a0e-b3f200e6c111 Relationship: title: Customer relationship type allOf: - $ref: '#/components/schemas/CustomerRelationshipTypeEnum' description: 'Type of relationship between the two customers (e.g. Child = the related customer is the child of this customer). Spouse Child Parent OtherFamily (Any familial relationship that doesn''t fit for the options provided) Friend Colleague Other' x-enumNames: - Spouse - Child - Parent - OtherFamily - Friend - Colleague - Other x-enumDescriptions: - '' - '' - '' - Any familial relationship that doesn't fit for the options provided - '' - '' - '' x-extensible: true example: string additionalProperties: false x-schema-id: CustomerRelationship ReservationPurpose: title: Reservation purpose enum: - Leisure - Business - Student type: string StringUpdateValue: title: String update value type: object properties: Value: type: string description: Value which is to be updated. nullable: true example: string additionalProperties: false x-schema-id: StringUpdateValue DocumentParameters: title: Identity document parameters type: object properties: Number: type: string description: Number of the document (e.g. passport number). nullable: true example: '1001' Expiration: type: string description: Expiration date in ISO 8601 format. format: date nullable: true example: '2026-06-02' Issuance: type: string description: Date of issuance in ISO 8601 format. format: date nullable: true example: '2026-06-02' IssuingCountryCode: type: string description: ISO 3166-1 code of the `Country`. nullable: true example: string IssuingCountrySubdivisionCode: type: string description: Identifier of the country subdivision where the document was issued (province, state or region). nullable: true example: string IssuingCity: type: string description: City from which document issued nullable: true example: string additionalProperties: false description: '' x-schema-id: DocumentParameters CancellationReason: enum: - Other - ConfirmationMissed - BookedElsewhere - ForceMajeure - GuestComplaint - NoShow - PriceTooHigh - ServiceNotAvailable - InputError - InvalidPayment - TravelAgency - RequestedByGuest - Update - BookingAbandoned - RequestedByBooker type: string securitySchemes: MewsClientToken: type: apiKey in: header name: ClientToken description: Mews authentication is performed by supplying ClientToken, AccessToken and Client as fields in the JSON request body (not as HTTP headers). This securityScheme is a tooling-compatible representation of the ClientToken credential. ClientToken is unique to your application and identifies the API client. MewsAccessToken: type: apiKey in: header name: AccessToken description: Tooling-compatible representation of the AccessToken credential, which is supplied in the JSON request body. AccessToken is unique to the connection with a property (enterprise) and identifies the property or properties whose data and services you can access. Portfolio Access Tokens enable multi-property access with a single token.