Travapi Agency API — Integration

Quick start

1. 1Register on the portal and generate your own sandbox key + secret (test). Live keys are enabled after Woxx approval.
2. 2Exchange your key for a 1-hour token via POST /v1/auth/token.
3. 3Send the token in the Authorization: Bearer header and search/book.

# 1) Token
curl -X POST https://api.entatil.com/v1/auth/token \
  -H "Content-Type: application/json" \
  -d '{"apiKey":"pk_sb_...","secret":"sk_sb_..."}'

# 2) Search hotels
curl -X POST https://api.entatil.com/v1/hotels/search \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"checkIn":"2026-08-08","checkOut":"2026-08-12","adults":2,"destinationId":1176,"currency":"EUR"}'

Authentication

API key + secret → short-lived JWT (1 hour). Reuse the token, refresh before it expires.

{
  "token": "eyJhbGciOiJ...",
  "token_type": "Bearer",
  "expires_in": 3599,
  "environment": "sandbox",
  "scopes": "hotel,tour,cruise"
}

Token lifetime is 1 hour; refresh based on expires_in (seconds).

Endpoints

Response envelope

The successful response of read endpoints has a single shape — always read response.data.

{ "data": <content>, "meta": { "requestId": "...", "environment": "sandbox" } }

Example — hotel search

Request

POST /v1/hotels/search
{
  "checkIn": "2026-08-08", "checkOut": "2026-08-12",
  "adults": 2, "destinationId": 1176,
  "currency": "EUR", "sourceCountryCode": "TR"
}

Response (truncated)

{
  "data": {
    "count": 1,
    "hotelData": [{
      "hotelId": 2007482, "name": "Rixos Beldibi", "stars": 5,
      "rooms": [{ "name": "CLASSIC ROOM", "rates": [{
        "rateKey": "2007482|866|...|1786147200|1786406400",
        "net": "24036.77", "boardName": "ALL INCLUSIVE", "currencyCode": "TRY"
      }] }]
    }]
  },
  "meta": { "requestId": "...", "environment": "sandbox" }
}

rateKey is the anchor of the booking — it carries the selected room/board/date combination and is used in the booking request.

Sandbox and Live

• Sandbox — Sandbox: test — booking is mock (no real record, returns an SBX- reference).
• Live — Live: real sales — currently closed; opens after pilot approval (payment via the agency current/credit account).

Error codes