Mews Customers API

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-

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