Escapra
Developer Platform

API Reference &
Developer Docs

Everything you need to build on top of the Escapra Hotel Connectivity Platform. Clean REST semantics, predictable errors, real-time webhooks, and a full sandbox.

Read the Docsopen_in_newRequest Sandbox Access
Authentication

Two methods. One standard.

Escapra supports OAuth 2.0 and API Key authentication depending on your integration type.

key

OAuth 2.0

Recommended for partner platforms. Client credentials flow with scoped access tokens. Token expiry: 1 hour with auto-refresh.

POST /v1/oauth/token
password

API Key

For server-to-server integrations. Pass your API key in the Authorization header. Keys scoped to a single environment.

Authorization: Bearer esc_live_...
API Examples

Common integration patterns.

Copy-paste starting points for the most common Escapra API operations.

Hotel Availability
GET /v1/hotels/{hotel_id}/availability
Authorization: Bearer {access_token}

# Query Parameters
check_in=2026-06-15&check_out=2026-06-18
adults=2&currency=EUR

# Response 200 OK
{
  "hotel_id": "{hotel_id}",
  "currency": "EUR",
  "rooms": [
    {
      "room_type_id": "DELUXE-KING",
      "room_name": "Deluxe King Room",
      "available": 4,
      "rate_plans": [{
        "rate_plan_id": "BAR-FLEX",
        "rate_name": "Best Available Rate",
        "total_price": 1240.00,
        "per_night": 413.33,
        "cancellation_policy": "free_cancellation_48h"
      }]
    }
  ]
}
Create Booking
POST /v1/bookings
Authorization: Bearer {access_token}
Idempotency-Key: {unique_key}

{
  "hotel_id": "{hotel_id}",
  "room_type_id": "DELUXE-KING",
  "rate_plan_id": "BAR-FLEX",
  "check_in": "2026-06-15",
  "check_out": "2026-06-18",
  "guest": {
    "first_name": "James",
    "last_name": "Morrison",
    "email": "j.morrison@example.com"
  },
  "currency": "EUR",
  "total_price": 1240.00
}

# Response 201 Created
{
  "booking_id": "BK-{id}",
  "status": "confirmed",
  "pms_confirmation": "{pms_ref}",
  "created_at": "2026-06-10T09:42:11Z"
}
Platform Features

Built for production use.

lock

OAuth 2.0 + API Keys

Standard OAuth 2.0 client credentials flow for partner integrations. API key auth for server-to-server connections. Token scoped to environment.

description

OpenAPI 3.1 Spec

Full OpenAPI 3.1 specification importable into Postman, Insomnia, or your preferred API client. Machine-readable schema for every endpoint.

science

Sandbox Environment

Full-featured sandbox with test hotel data. No production bookings, no billing risk. Every endpoint available before going live.

webhook

Webhook Events

Subscribe to booking confirmed, modified, and cancelled events. HMAC-signed payloads with delivery guarantees and replay protection.

speed

Sub-Second Responses

p95 latency under 800ms for availability searches. Designed for real-time applications. Event-driven architecture — no polling required.

support

Developer Support

Technical documentation at docs.escapra.com. Integration support via the partner portal. API changelog with deprecation notices.

Request sandbox access.

Get full access to the Escapra sandbox to test your integration before going live. No production data, no billing risk, every endpoint available.

Request Accessdocs.escapra.com →