For Developers

Developer API

Connect Bedoka inventory, price and availability data, and reservation events to your own system.

Live · Self-service API keys from the panel

The Bedoka public API lets hotel and technology partners access Bedoka inventory programmatically. You can pull hotel and room data, query live price and availability, and receive reservation events in real time via webhooks. The API is currently in beta, and access is granted by application.

What can you do?

Hotel inventory

List and map hotel, room-type and board information programmatically.

Price & availability

Pull date-based price and allotment data and keep it current in your own system.

Reservation webhooks

Receive new-reservation, change and cancellation events at your endpoint in real time.

Authentication

Every request is authorised with an API key that you generate yourself from panel.bedoka.com → Channel Manager (per hotel). Send it in the Authorization: Bearer header. Keys must be kept secret, stored only server-side, and never exposed in client code.

Example requests

Below: pull availability/price, push ARI, pull reservations, and the webhook payload:

# 1) Pull availability + price (in minor units / kuruş)
GET https://api.bedoka.com/v1/partner/availability?from=2026-07-01&to=2026-07-05
Authorization: Bearer bdk_live_xxxxxxxxxxxxxxxx

# 200 OK
{ "from": "2026-07-01", "to": "2026-07-05", "rooms": [
  { "roomCode": "STD-DBL", "days": [
    { "date": "2026-07-01", "available": 4, "priceCents": 8400, "closed": false }
  ] }
] }

# 2) Push availability + price (ARI) — upsert per (roomCode, date)
PUT https://api.bedoka.com/v1/partner/availability
Authorization: Bearer bdk_live_xxxxxxxxxxxxxxxx
Content-Type: application/json
{ "updates": [
  { "roomCode": "STD-DBL", "date": "2026-07-01", "available": 3, "priceCents": 9000 },
  { "roomCode": "STD-DBL", "date": "2026-07-02", "available": 0, "closed": true }
] }

# 3) Pull reservations
GET https://api.bedoka.com/v1/partner/bookings?from=2026-07-01&to=2026-07-31

# 4) Webhook (new/confirmed booking) — POSTed to your endpoint
# Header: x-bedoka-signature: HMAC-SHA256(secret, body)
{ "event": "booking.confirmed", "data": {
  "code": "BK-XXXX", "roomCode": "STD-DBL", "checkin": "2026-07-01",
  "checkout": "2026-07-05", "totalPriceCents": 33600 } }

Rate limit

API usage is subject to fair-use limits. During beta, the default limit is 60 requests per minute per partner. When the limit is exceeded, the endpoint returns 429 Too Many Requests; your client is expected to honour the Retry-After header. Higher-limit needs are evaluated on application.

API key

Authorisation via Bearer token.

60 req / min

Beta default rate limit.

Webhooks

Reservation events delivered in real time.

Start integrating

Sign in to your hotel panel, generate an API key on the Channel Manager page, and start pushing availability and rates. No hotel account yet? Create one free in minutes.