Getting started

This section provides a quick-start guide to help you begin your integration development. For comprehensive instructions on using the API, please refer to our Usage guidelines.

Terminology

Some of the terms used in the API, such as enterprise, customer or resource may not be familiar. For example, we use resource to describe guest rooms and other types of bookable space. For a full description of all the terms used, see the Mews Glossary for Open API users.

Quick start

Mews operates several environments. To start your development process, you will want to use one of the Demo environments. You can switch to the Production environment when your development is complete and your integration is certified.

To get yourself familiar with the Mews system and the types of data we provide, you can log in to Mews Operations using the email and password provided and check out the system features. Alternatively, you can start using the API right away, using the demo tokens below.

Requests towards our API should be in JSON format and sent using POST method. Below is an example request which will return the configuration details for one of our test hotels. You can find out more about this API operation in Get configuration.

Endpoint URL:

https://api.mews-demo.com/api/connector/v1/configuration/get

Request payload:

{
    "ClientToken": "E0D439EE522F44368DC78E1BFB03710C-D24FB11DBE31D4621C4817E028D9E1D",
    "AccessToken": "7059D2C25BF64EA681ACAB3A00B859CC-D91BFF2B1E3047A3E0DEC1D57BE1382",
    "Client": "NameOfYourCompanyOrApplication"
}

If the response looks something like this, you've successfully made your first request!

{
    "NowUtc": "2021-05-05T11:39:29Z",
    "Enterprise": {
        "Id": "c65ea6e9-2340-42f4-9136-ab3a00b6da22",
        "ChainId": "8ddea57b-6a5c-4eec-8c4c-24467dce118e",
        "CreatedUtc": "2020-01-06T11:05:44Z",
        "Name": "Connector API Hotel (Net Pricing) TEST",
        "TimeZoneIdentifier": "America/New_York",
        "LegalEnvironmentCode": "US-DC",
        "AccommodationEnvironmentCode": "US",
        "AccountingEnvironmentCode": "DEFAULT",
        "TaxEnvironmentCode": "US-DC",
        "DefaultLanguageCode": "en-US",
        "EditableHistoryInterval": "P0M2DT0H0M0S",
        "WebsiteUrl": "https://www.mews.com/",
        "Email": "[e-mail]",
        "Phone": "[phone]xx",
        "LogoImageId": "c90a8d7e-a332-45c0-ac44-ac5600a4116e",
        "CoverImageId": "c867f682-4003-4518-b96c-abec0090a23b",
        "Address": {},
        "Currencies": [],
        "Pricing": "Net",
        "TaxPrecision": null
    },
    "PaymentCardStorage": {
        "PublicKey": "1100016827"
    }
}

Next steps

There are several serialization patterns that you should get familiar with in order to use the API correctly. For example, we work with times in UTC so you should be aware of the timezone the property is in, as well as any daylight saving time changes, and adjust accordingly.

If you receive an error response, check the response codes and the message specified in response details to determine what went wrong. Note that if you encounter a 429 error with one of the testing demo credentials, it may be that multiple developers are using the same demo credentials and have exhausted our request limits. To minimize the impact this may have on your development efforts, we provide multiple sets of tokens for the test hotels that you can use in Demo.

Be aware that some 'get' operations use pagination to manage performance when fetching potentially large amounts of data. For other tips on how to get the most out of your integration, see our best practices.