B2B API — Great Tours

Everything You Need to Build

A complete hotel booking API designed for travel agencies, OTAs, and developers who need reliability at scale.

REST API

Standard JSON over HTTPS with a simple Token header for authentication. Works with any language or framework — C#, PHP, Python, JavaScript, Ruby and more.

Real-Time Availability

Live inventory from 50,000+ properties. Availability, rates and room types updated in real time with no caching delays.

Instant Confirmation

Bookings confirmed in under 500ms with a unique reference number. No manual back-office processing or delays.

Sandbox Environment

Full sandbox with test credentials, mock data and simulated booking flows. Build and test without incurring real charges.

Reporting & Analytics

Dashboard with booking volume, revenue, conversion funnels and cancellation data. Export to CSV or via reporting API endpoints.

Dedicated Support

Dedicated technical account manager, priority Slack channel, SLA-backed response times and onboarding assistance.

Core API Endpoints

All endpoints require your API key in the Token request header. Base URL: https://www.greattours.am/webservice

GET

/GetLocations

List all countries and the regions available within each. Use to populate destination dropdowns and cache the location catalog on your side.

🔑 Token Header

POST

/SearchHotels

Search the hotel inventory by destination, dates, and guest configuration. Returns the cheapest matching offer per hotel. Response time 30–120 seconds (multi-operator fan-out) — use a long client timeout.

🔑 Token Header

POST

/SingleHotelPrice

Drill-down: returns every available room × meal-plan × price combination for one specific hotel. Use after /SearchHotels when the partner picks a hotel and wants all options.

🔑 Token Header

Example Request

cURL

# Search hotels in Paris, 21–28 May 2026, 1 adult
curl -X POST "https://www.greattours.am/webservice/SearchHotels" \
  -H "Token: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "Country":   "France",
    "Region":    "Paris",
    "StartDate": "/Date(1779580800000)/",
    "EndDate":   "/Date(1780185600000)/",
    "AdultQTY":  1,
    "ChildQTY":  0,
    "ChildAge1": -1,
    "ChildAge2": -1,
    "ChildAge3": -1,
    "NightQTY":  7,
    "APIKey":    "E3CE4644-0494-4749-94B7-CF2D92FDBEC2"
  }'

JavaScript

// Build WCF /Date(ms)/ format from a Date object
const wcfDate = d => `/Date(${d.getTime()})/`;

const response = await fetch('https://www.greattours.am/webservice/SearchHotels', {
  method: 'POST',
  headers: {
    'Token':        API_KEY,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    Country:   'France',
    Region:    'Paris',
    StartDate: wcfDate(new Date('2026-05-21')),
    EndDate:   wcfDate(new Date('2026-05-28')),
    AdultQTY:  1,
    ChildQTY:  0,
    ChildAge1: -1,
    ChildAge2: -1,
    ChildAge3: -1,
    NightQTY:  7,
    APIKey:    'E3CE4644-0494-4749-94B7-CF2D92FDBEC2',
  }),
});

const data = await response.json();
if (data.StatusCode !== 200) throw new Error(data.ErrorMsg);
console.log(data.Response);

Python

import requests
from datetime import datetime, timezone

def wcf_date(d):
    return f"/Date({int(d.replace(tzinfo=timezone.utc).timestamp() * 1000)})/"

response = requests.post(
    "https://www.greattours.am/webservice/SearchHotels",
    headers={"Token": API_KEY, "Content-Type": "application/json"},
    json={
        "Country":   "France",
        "Region":    "Paris",
        "StartDate": wcf_date(datetime(2026, 5, 21)),
        "EndDate":   wcf_date(datetime(2026, 5, 28)),
        "AdultQTY":  1,
        "ChildQTY":  0,
        "ChildAge1": -1,
        "ChildAge2": -1,
        "ChildAge3": -1,
        "NightQTY":  7,
        "APIKey":    "E3CE4644-0494-4749-94B7-CF2D92FDBEC2",
    },
    timeout=180,
)

data = response.json()
if data["StatusCode"] != 200:
    raise Exception(data["ErrorMsg"])
print(data["Response"])

Response Envelope

JSON

{
  "StatusCode": 200,
  "ErrorMsg":   "",
  "Response": [
    {
      "HotelName":     "New Hotel Saint Lazare",
      "Town":          "Paris",
      "Category":      "4*",
      "Room":          "Standard Double",
      "Board":         "Breakfast",
      "Price":         850.00,
      "Currency":      "EUR",
      "NightQTY":      7
    }
  ]
}

Every response uses the same envelope: StatusCode (200 = success), ErrorMsg (empty on success), and Response (the endpoint-specific payload — an array or object).

API Pricing Plans

Transparent pricing with no setup fees. Start free and scale as your business grows.

Starter

Free / month

Perfect for testing and small agencies getting started with API integration.

1,000 API calls / month
Sandbox environment
Hotel search & availability
Email support
Live bookings
Net rate access
Dedicated account manager

Apply for API Access

Fill in the form below and our partnerships team will get back to you within 1 business day.

Request API Credentials

Tell us about your business and integration plans so we can set up the right plan for you.

First Name

Last Name

Company / Agency Name

Business Email

Website / Platform URL

Monthly Booking Volume (estimate)

Intended Plan

Tell us about your integration

The Great Tours
B2B Hotel API

Everything You Need to Build

REST API

Real-Time Availability

Instant Confirmation

Sandbox Environment

Reporting & Analytics

Dedicated Support

Core API Endpoints

Example Request

API Pricing Plans

Apply for API Access

Request API Credentials

Welcome back

The Great ToursB2B Hotel API

Everything You Need to Build

REST API

Real-Time Availability

Instant Confirmation

Sandbox Environment

Reporting & Analytics

Dedicated Support

Core API Endpoints

Example Request

API Pricing Plans

Apply for API Access

Request API Credentials

Welcome back

The Great Tours
B2B Hotel API