edit

Getting Started

Welcome to Ratemarkt Client API ❤️

Introduction

Ratemarkt Client API is a quite intuitive HTTP based JSON API designed to make it very easy to get integrated with Ratemarkt as a client.

It just requires a single API key put in HTTP headers to get authenticated and introduces only a few resources in total to get all the job done with ease.

Location

Ratemarkt API is currently located at api.ratemarkt.com domain under v1 directory of which the directory name also denotes the current API version you use.

Any API call requires a secure HTTPS connection (HTTP over SSL) and must be authenticated by using an API key to get granted for API resources.

Here is the base url for any API call.

1
https://api.ratemarkt.com/v1/

For instance, you should call the url below for check hotels endpoint.

1
https://api.ratemarkt.com/v1/checkhotels

Authentication

In order to get autheticated against Ratemarkt API please see Authentication page. Once you get authenticated you will be able to access the resources below.

Resources

All the API resources below accepts a JSON query object via HTTP post method for the sake of simplicity.

Name Resource Path Description
Check Hotels /checkhotels Get availabile hotels by using a destination id or a list of hotel codes.
Check Hotel /checkhotel Single hotel availability for more recent data.
Check Rate /checkrate Single rate availability with the most recent data.
Book Rate /bookrate Make a booking from a selected rate by using its rate key.
Check Booking /checkbooking Query the booking status using either booking reference or client reference.
Check Bookings /checkbookings List bookings between two dates
Cancel Booking /cancelbooking Cancel refered booking when desired.

Errors

To see how Ratemarkt API handles exceptional situations and errors please refer to our Errors pages.

Client Libraries

Are you looking for a client library for your favorite programming language? Then you should take a look at our Client Libraries section .

Example API Request / Response

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
$ curl -X POST -H "Authorization: Bearer <YOUR_API_KEY_HERE>" https://api.ratemarkt.com/v1/checkrate -d'{
    "rateKey": "[Q9k|3|USD|US|[[2|[]]]]_[AJ62Fw|ANMdEg|NET|0|5pyO3Q|[jVOYrg|2|0]]"
}'
...
{
  "hotel": {
    "hotelCode": "d31d12",
    "hotelName": "The Marmara Taksim",
    "destinationCode": "c36ca9",
    "destinationName": "istanbul",
    "countryCode": "TR",
    "rates": [
      {
        "rateType": "NET",
        "rateKey": "[Q9k|3|USD|US|[[2|[]]]]_[AJ62Fw|ANMdEg|NET|0|5pyO3Q|[jVOYrg|2|0]]",
        "nonrefundable": false,
        "boardType": "RO",
        "boardName": "Room Only",
        "rate": 591.19,
        "currency": "EUR",
        "rooms": [
          {
            "numberOfAdults": 2,
            "childrenAges": [],
            "roomDescription": "DOUBLE DELUXE CITY VIEW",
            "sequence": 1
          }
        ],
        "cancellationPolicies": [
          {
            "amount": 175.95,
            "fromDate": "2017-07-19T23:59:00+03:00"
          }
        ],
        "remarks": "CONTRACT VALID FOR JUNIOR ROOM TYPES .  Check-in hour 15:00 - .",
        "commission": null,
        "hotelCurrency": null,
        "hotelRate": null
      }
    ]
  }
}
'