Getting started

1. Get your credentials

Kong Gateway sits in front of the Partner API. It checks your API key, applies your contracted quotas and tells the API who you are.

Send the key in the apikey header on every request. Keep it on your server. Never ship it in a browser or mobile app.

2. Make your first request

The API runs on seeded inventory, so this request returns live, all-in prices for both New York hotels:

curl "https://api.konghotels.cloud/availability?destination=new-york&check_in=2026-12-04&check_out=2026-12-07&adults=2" \
  -H "apikey: $KONG_HOTELS_API_KEY"

const params = new URLSearchParams({
  destination: 'new-york',
  check_in: '2026-12-04',
  check_out: '2026-12-07',
  adults: '2',
})

const res = await fetch(`https://api.konghotels.cloud/availability?${params}`, {
  headers: { apikey: process.env.KONG_HOTELS_API_KEY },
})
const { data } = await res.json()

import os
import requests

res = requests.get(
    "https://api.konghotels.cloud/availability",
    params={"destination": "new-york", "check_in": "2026-12-04", "check_out": "2026-12-07", "adults": 2},
    headers={"apikey": os.environ["KONG_HOTELS_API_KEY"]},
)
data = res.json()["data"]

Each result is the cheapest sellable offer for one hotel. Follow links.availability to see every room type and rate plan, fully priced:

{
  "property": { "code": "KTNYC", "name": "Kong Tower Manhattan", "brand": "kong-tower", "star_rating": 5, "city": "New York" },
  "currency": "USD",
  "offer_count": 16,
  "lowest_offer": {
    "room_type_code": "TWRK",
    "room_type_name": "Tower King",
    "rate_plan_code": "ADV",
    "meal_plan": "room_only",
    "is_refundable": false,
    "average_nightly_rate": "358.33",
    "tax_total": "169.06",
    "total": "1244.06"
  },
  "links": {
    "availability": "https://api.konghotels.cloud/properties/KTNYC/availability?check_in=2026-12-04&check_out=2026-12-07&adults=2"
  }
}

Amounts are decimal strings in the hotel's currency. Read Money, dates & times before you display them.

3. Your partner identity

After authenticating you, the gateway forwards your consumer identity in X-Consumer-Custom-ID, X-Consumer-ID or X-Consumer-Username (the first non-empty one wins). That identity is your partner ID.

Quotes, holds, reservations, group requests and webhooks are private to the partner that created them. Asking for another partner's resource returns 404, not 403.

4. Explore the demo reservations

The demo-partner identity owns six seeded reservations, KH4DEMO01 to KH4DEMO06, so you can try the reservation, folio and cancellation-quote endpoints while writes are off:

curl "https://api.konghotels.cloud/reservations?per_page=6" -H "apikey: $KONG_HOTELS_API_KEY"
curl "https://api.konghotels.cloud/reservations/KH4DEMO01/folio" -H "apikey: $KONG_HOTELS_API_KEY"

See Test data for property codes, Kong Rewards members and promotion codes.

Next steps