Mews

aid: mews-com
url: https://raw.githubusercontent.com/api-evangelist/mews-com/refs/heads/main/apis.yml
apis:
  - aid: mews-com:mews-connector-api
    name: Mews Connector API
    tags:
      - Hospitality
      - Hotel
      - PMS
      - Property Management
      - Reservations
      - Connector
    humanURL: https://docs.mews.com/connector-api
    baseURL: https://api.mews.com/api/connector/v1
    properties:
      - url: https://docs.mews.com/connector-api
        type: Documentation
      - url: https://docs.mews.com/connector-api/guidelines
        name: Usage Guidelines
        type: Documentation
      - url: https://docs.mews.com/connector-api/concepts
        name: Concepts
        type: Documentation
      - url: https://docs.mews.com/connector-api/operations
        name: API Operations
        type: Documentation
      - url: https://docs.mews.com/connector-api/api-events
        name: API Events
        type: Webhooks
      - url: https://api.mews.com/Swagger/connector/swagger.yaml
        name: Connector API Swagger (OpenAPI)
        type: OpenAPI
      - url: openapi/mews-connector-api-openapi.yml
        type: OpenAPI
      - url: json-schema/mews-reservation-schema.json
        type: JSONSchema
      - url: json-schema/mews-customer-schema.json
        type: JSONSchema
      - url: json-ld/mews-com-context.jsonld
        type: JSONLD
    description: >-
      General-purpose API that gives partners of Mews access to data and services in Mews Operations. Covers
      reservations, customers, companies, accounting, bills, payments, rates and availability, products and services,
      enterprises and resources, cashiers and counters, exports, loyalty memberships, devices and printers, customer
      messaging, billing automations, vouchers, restrictions, and resource access tokens. JSON-over-HTTPS
      request/response with `ClientToken` + `AccessToken` authentication; 197 operations across ~30 resource groups;
      webhooks delivered as API Events.
  - aid: mews-com:mews-booking-engine-api
    name: Mews Booking Engine API
    tags:
      - Hospitality
      - Hotel
      - Booking Engine
      - Reservations
      - Direct Bookings
    humanURL: https://docs.mews.com/booking-engine-guide/booking-engine-api
    baseURL: https://api.mews.com/api/bookingEngine/v1
    properties:
      - url: https://docs.mews.com/booking-engine-guide/booking-engine-api
        type: Documentation
      - url: https://api.mews.com/Swagger/bookingEngine/swagger.yaml
        name: Booking Engine API Swagger (OpenAPI)
        type: OpenAPI
      - url: openapi/mews-booking-engine-api-openapi.yml
        type: OpenAPI
    description: >-
      Web API for booking engines and booking widgets to interact programmatically with Mews — fetch offered rooms and
      spaces, check availability and pricing, retrieve products and promotions, authorize payment cards, and create
      reservation groups. Covers services, restrictions, exchange rates, payment configuration, and reservation pricing
      for a single property.
  - aid: mews-com:mews-distributor-api
    name: Mews Distributor API
    tags:
      - Hospitality
      - Hotel
      - Booking
      - Distribution
      - Direct Bookings
    humanURL: https://docs.mews.com/distributor-api
    baseURL: https://api.mews.com/api/distributor/v1
    properties:
      - url: https://docs.mews.com/distributor-api
        type: Documentation
      - url: https://api.mews.com/Swagger/distributor/swagger.yaml
        name: Distributor API Swagger (OpenAPI)
        type: OpenAPI
      - url: openapi/mews-distributor-api-openapi.yml
        type: OpenAPI
    description: >-
      Legacy/distribution surface used by the Mews-hosted booking widget. Retrieves hotel info, availability and
      pricing, language/currency/country reference data, payment configuration, voucher validation, exchange rates, and
      reservation creation. Same JSON-over-HTTPS shape and token auth as the Connector API.
  - aid: mews-com:mews-channel-manager-api
    name: Mews Channel Manager API
    tags:
      - Hospitality
      - Hotel
      - Channel Manager
      - Distribution
      - Inventory
    humanURL: https://docs.mews.com/channel-manager-api
    properties:
      - url: https://docs.mews.com/channel-manager-api
        type: Documentation
      - url: https://docs.mews.com/channel-manager-api/usage-guidelines
        name: Usage Guidelines
        type: Documentation
      - url: https://docs.mews.com/channel-manager-api/concepts
        name: Concepts
        type: Documentation
      - url: https://docs.mews.com/channel-manager-api/changelog
        name: Changelog
        type: ChangeLog
    description: >-
      Two-way API for channel managers and distribution channels. Mews-side operations let channel managers receive
      reservations from Mews; channel-manager-side endpoints let Mews push availability, rate, and inventory updates
      outbound. Mediates OTA, GDS, and metasearch traffic into the Mews reservation graph.
  - aid: mews-com:mews-pos-api
    name: Mews POS API
    tags:
      - Hospitality
      - Hotel
      - POS
      - Point of Sale
      - Food and Beverage
    humanURL: https://docs.mews.com/pos-api
    properties:
      - url: https://docs.mews.com/pos-api
        type: Documentation
    description: >-
      API for Point-of-Sale systems to integrate with Mews — provides real-time visibility into F&B operations including
      outlets, items, orders, and invoices, and pushes charges onto guest bills inside the Mews PMS. Used by partner POS
      vendors and Mews POS itself.
  - aid: mews-com:mews-loyalty-partner-api
    name: Mews Loyalty Partner API
    tags:
      - Hospitality
      - Hotel
      - Loyalty
      - Members
      - Rewards
    humanURL: https://docs.mews.com/loyalty-partner-api
    properties:
      - url: https://docs.mews.com/loyalty-partner-api
        type: Documentation
    description: >-
      Reverse API for loyalty program providers — Mews calls the partner's endpoints to look up members, validate
      enrollment, fetch tier and benefit data, and record earn/redeem activity during the guest journey. Complements the
      Connector API Loyalty operation group on the Mews side.
name: Mews
tags:
  - Hospitality
  - Hotel
  - PMS
  - Property Management
  - Travel
  - Booking
  - Reservations
  - Cloud
  - SaaS
kind: contract
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
access: 3rd-Party
common:
  - type: PostmanWorkspace
    url: https://www.postman.com/kinlaneapi/mews/overview
  - type: ArazzoWorkflows
    url: arazzo/
    workflows:
      - url: arazzo/mews-com-add-companion-to-reservation-workflow.yml
        name: Mews Add Companion to Reservation
        summary: Create a companion guest profile and attach it to a reservation.
      - url: arazzo/mews-com-add-customer-add-reservation-workflow.yml
        name: Mews Add Customer and Add Reservation
        summary: Create a guest profile, then book a reservation for that guest.
      - url: arazzo/mews-com-add-product-to-reservation-workflow.yml
        name: Mews Add Product to Reservation
        summary: Resolve a product on a service, then attach it to a reservation.
      - url: arazzo/mews-com-attach-identity-document-workflow.yml
        name: Mews Attach Identity Document
        summary: Find a guest by name, then attach an identity document to their profile.
      - url: arazzo/mews-com-cancel-reservation-workflow.yml
        name: Mews Cancel Reservation
        summary: Locate a cancellable reservation and cancel it, optionally posting a fee.
      - url: arazzo/mews-com-capture-credit-card-payment-workflow.yml
        name: Mews Capture Credit Card Payment
        summary: Locate a reservation, find its guest, then charge a credit card payment.
      - url: arazzo/mews-com-check-in-reservation-workflow.yml
        name: Mews Check In Reservation
        summary: Locate a reservation, confirm it if needed, then start it (check in).
      - url: arazzo/mews-com-check-out-reservation-workflow.yml
        name: Mews Check Out Reservation
        summary: Locate a started reservation and process it (check out) closing its bills.
      - url: arazzo/mews-com-extend-reservation-stay-workflow.yml
        name: Mews Extend Reservation Stay
        summary: Locate a reservation and move its interval to a new start and end.
      - url: arazzo/mews-com-find-or-create-customer-workflow.yml
        name: Mews Find or Create Customer
        summary: Search for a guest by name and create the profile only when none exists.
      - url: arazzo/mews-com-post-room-service-order-workflow.yml
        name: Mews Post Room Service Order
        summary: Resolve a guest's reservation, then post a point-of-sale order to it.
      - url: arazzo/mews-com-price-then-book-reservation-workflow.yml
        name: Mews Price then Book Reservation
        summary: Quote a reservation price first, then create the reservation once accepted.
      - url: arazzo/mews-com-quote-rate-pricing-workflow.yml
        name: Mews Quote Rate Pricing
        summary: Resolve a rate on a service, then read its price across a date range.
      - url: arazzo/mews-com-reassign-reservation-guest-workflow.yml
        name: Mews Reassign Reservation Guest
        summary: Find or create a guest profile, then set it as a reservation's customer.
      - url: arazzo/mews-com-record-external-payment-workflow.yml
        name: Mews Record External Payment
        summary: Locate a reservation's guest account, then record an external payment.
      - url: arazzo/mews-com-refund-payment-workflow.yml
        name: Mews Refund Payment
        summary: Find a refundable payment on a reservation, then refund it.
      - url: arazzo/mews-com-reservation-accounting-summary-workflow.yml
        name: Mews Reservation Accounting Summary
        summary: Resolve a reservation's guest account, then pull its accounting items.
      - url: arazzo/mews-com-service-availability-to-reservation-workflow.yml
        name: Mews Service Availability to Reservation
        summary: Resolve a service, check category availability, then book if space exists.
      - url: arazzo/mews-com-update-customer-details-workflow.yml
        name: Mews Update Customer Details
        summary: Find a guest by name, then update their contact details on the profile.
      - url: arazzo/mews-com-update-rate-pricing-workflow.yml
        name: Mews Update Rate Pricing
        summary: Resolve a rate, update its price for a range, then re-read to verify.
  - type: Portal
    url: https://www.mews.com/
  - type: Documentation
    url: https://docs.mews.com/
    name: Mews Open API Docs
  - type: Documentation
    url: https://www.mews.com/en/products/api
    name: Mews Open API Product Page
  - type: Documentation
    url: https://docs.mews.com/connector-api/getting-started
    name: Getting Started — Connector API
  - type: GitHubOrganization
    url: https://github.com/MewsSystems
  - type: Documentation
    url: https://github.com/MewsSystems/open-api-docs
    name: Mews Open API Docs (source)
  - type: Marketplace
    url: https://www.mews.com/en/marketplace
    name: Mews Marketplace
  - type: SignUp
    url: https://www.mews.com/en/partnerships
    name: Partner Program
  - type: Support
    url: https://help.mews.com/
    name: Mews Help Center
  - type: Forum
    url: https://community.mews.com/
    name: Mews Community
  - type: Blog
    url: https://www.mews.com/en/blog
  - type: StatusPage
    url: https://status.mews.com/
  - type: Pricing
    url: https://www.mews.com/en/pricing
    name: Mews Pricing
  - type: TermsOfService
    url: https://www.mews.com/en/terms-conditions/partners
    name: Partner Terms
  - type: PrivacyPolicy
    url: https://www.mews.com/en/privacy-policy
  - type: TrustCenter
    url: https://trust.mews.com/
    name: Mews Trust Center
  - type: Webhooks
    url: https://docs.mews.com/connector-api/api-events
    name: Connector API Events
  - type: RateLimits
    url: https://docs.mews.com/connector-api/guidelines
    name: Connector API Rate Limits
  - type: Errors
    url: https://docs.mews.com/connector-api/guidelines
    name: Error Handling
  - type: Versioning
    url: https://docs.mews.com/connector-api/changelog
    name: Connector API Changelog
  - type: ChangeLog
    url: https://docs.mews.com/connector-api/changelog
  - type: SDK
    url: https://github.com/MewsSystems/fiscalizations
    name: Mews Fiscalizations (.NET)
  - type: SDK
    url: https://github.com/MewsSystems/mews-flutter
    name: Mews Flutter / Dart Packages
  - type: CodeExamples
    url: https://github.com/MewsSystems/awesome-mews
    name: Awesome Mews
  - type: Tool
    url: https://github.com/MewsSystems/developers
    name: Mews Developer Resources
  - type: LinkedIn
    url: https://www.linkedin.com/company/mews-systems/
  - type: X
    url: https://x.com/mewssystems
  - type: YouTube
    url: https://www.youtube.com/@MewsSystems
  - type: Careers
    url: https://www.mews.com/en/careers
  - type: Plans
    url: plans/mews-com-plans-pricing.yml
  - type: RateLimits
    url: rate-limits/mews-com-rate-limits.yml
  - type: FinOps
    url: finops/mews-com-finops.yml
  - type: Vocabulary
    url: vocabulary/mews-com-vocabulary.yml
  - type: SpectralRules
    url: rules/mews-com-rules.yml
  - type: Features
    data:
      - >-
        Cloud-native, multi-tenant hospitality operating system covering PMS, POS, RMS, Payments, Booking Engine, and
        Marketplace
      - >-
        Connector API exposes 197 operations across ~30 resource groups (reservations, customers, companies, accounting,
        bills, rates, availability, services, products, enterprises, resources, cashiers, counters, exports, loyalty,
        devices, customer messaging, billing automations, vouchers, restrictions, resource access tokens)
      - >-
        JSON-over-HTTPS request/response model — every operation is a POST returning JSON; auth is `ClientToken`
        (partner) + `AccessToken` (property) + `Client` (user-agent string)
      - >-
        Production environment at `https://api.mews.com`, demo environment at `https://api.mews-demo.com` with free test
        credentials
      - >-
        Multi-property support via Portfolio Access Tokens and `ChainIds` filter — one API call can span an entire hotel
        chain
      - Webhooks delivered as API Events (push HTTP POST) for reservation, customer, bill, payment, and resource changes
      - >-
        Marketplace ecosystem with 1,000+ pre-built integrations and 20,000+ installations across Mews-powered
        properties
      - 10M+ daily API messages in production
      - >-
        Booking Engine API for custom booking widgets — availability, pricing, products, promotions, payment-card
        authorization, reservation group creation
      - Distributor API (legacy/booking-widget surface) for hotel info, availability, vouchers, and reservation creation
      - >-
        Channel Manager API for two-way integration with OTAs, GDS, and metasearch — inventory and rate push,
        reservation pull
      - POS API for Point-of-Sale partners — outlets, items, orders, invoices, and bill posting
      - Loyalty Partner API (reverse webhook) — Mews calls the loyalty provider for member lookup, earn, redeem
      - Embedded Mews Payments — tokenization, automated reconciliation, multi-currency, terminal integration
      - SOC 2, ISO 27001, and PCI DSS compliant
      - Open-source contributions: Mews Flutter packages, Fiscalizations .NET library, gitbook-based open-api-docs
      - >-
        Pricing is quote-based per property — no public price list; commercial terms negotiated with the partner success
        team
    sources:
      - https://www.mews.com/en/products/api
      - https://docs.mews.com/
      - https://docs.mews.com/connector-api
      - https://docs.mews.com/booking-engine-guide/booking-engine-api
      - https://docs.mews.com/channel-manager-api
      - https://github.com/MewsSystems
      - https://www.mews.com/en/marketplace
    updated: '2026-05-25'
created: '2026-05-25'
modified: '2026-05-25'
position: Producing
description: >-
  Mews is a cloud-native hospitality operating system serving 15,000+ hotels, hostels, and vacation-rental properties
  across 85 countries. Founded in Prague in 2012 by Richard Valtr and Matthijs Welle and reaching unicorn status in
  2024, Mews offers an integrated Property Management System, Point of Sale, Revenue Management, embedded Payments,
  Booking Engine, and a Marketplace of 1,000+ third-party apps. The Mews Open API surface — Connector, Booking Engine,
  Distributor, Channel Manager, POS, and Loyalty Partner APIs — handles 10M+ messages per day and is the integration
  backbone for the modern hotel tech stack.
maintainers:
  - FN: Kin Lane
    email: info@apievangelist.com
    X: apievangelist
    url: https://apievangelist.com
specificationVersion: '0.16'