Documentation

Technical documentation

A high-level overview of how partners connect to availability, booking and inventory feeds. Full API reference and credentials are shared with approved partners.

This is a public overview, not the complete reference. Contact us to receive full API documentation, a sandbox key and sample payloads for your account.

Overview

The Connect API is a JSON-over-HTTPS interface exposing the automatable part of our Istanbul inventory: availability search, net-rate pricing and booking with instant confirmation. Feed-based partners receive the same product data as a structured XML inventory feed.

Authentication

Requests are authenticated with a per-partner API key sent in an Authorization header over TLS. Keys are issued per environment (sandbox and production) during onboarding.

# Authorization header
Authorization: Bearer sk_live_xxxxxxxxxxxxxxxx
Accept: application/json

Availability

Query live availability and net rates for a product and date range before you sell. The response returns bookable options with prices and rules.

GET /v1/availability?product=hagia-sophia-grand-bazaar&date=2026-06-14

200 OK
{
  "product": "hagia-sophia-grand-bazaar",
  "currency": "EUR",
  "available": true,
  "options": [
    { "time": "09:00", "net": 149.50, "confirmation": "instant" }
  ]
}

Booking

Create a booking against an available option. A successful response returns a confirmation reference and voucher details immediately for standard inventory.

POST /v1/bookings
{
  "product": "hagia-sophia-grand-bazaar",
  "date": "2026-06-14",
  "time": "09:00",
  "pax": { "adults": 2, "children": 1 },
  "lead": { "name": "...", "email": "..." }
}

201 Created
{ "reference": "MKN-8F3A21", "status": "confirmed" }

Inventory feeds

Partners that prefer catalogue sync receive an XML feed of products, descriptions, rates and rules, pulled on a schedule or on demand. The feed maps cleanly onto most agency and OTA catalogues.

GET /feed/inventory.xml

<product code="hagia-sophia-grand-bazaar" type="tour">
  <title>Hagia Sophia & Grand Bazaar Tour</title>
  <duration>PT8H</duration>
  <net currency="EUR">149.50</net>
  <pickup>hotel</pickup>
</product>

Need the full reference?

Approved partners receive complete endpoint documentation, a sandbox key and sample payloads. Tell us your use case and we will provision access.

Request API documentation