TRP Partner Hotel API

Exchange partner client_id and client_secret for access and refresh tokens.

Request body

Sample request

{
  "grant_type": "client_credentials",
  "client_id": "your_client_id",
  "client_secret": "your_client_secret"
}

{
  "status": true,
  "access_token": "eyJhbGciOiJIUzI1NiIs...",
  "refresh_token": "eyJhbGciOiJIUzI1NiIs...",
  "token_type": "Bearer",
  "expires_in": 14400,
  "refresh_expires_in": 604800,
  "agent": { "id": 10049, "email": "agent@example.com" }
}

Refresh an expired access token using a valid refresh token and active session.

{
  "grant_type": "refresh_token",
  "refresh_token": "eyJhbGciOiJIUzI1NiIs..."
}

Liveness check. No authentication required.

Returns the authenticated agent's credit limit and currency.

Auth: Bearer required

{
  "status": true,
  "data": {
    "creditLimit": 500000,
    "currency": "INR"
  },
  "requestId": "..."
}

List countries for nationality and destination setup.

* At least one of stateId or countryId is required. Use location_id from results as cityId in search.

Start an asynchronous hotel availability search. Returns searchId immediately.

{
  "checkIn": "2026-09-10",
  "checkOut": "2026-09-12",
  "nationality": "IN",
  "cityId": "24",
  "rooms": [
    { "adults": 2, "children": 1, "childAges": [5] }
  ]
}

{
  "status": true,
  "data": { "searchId": "a6784cb565f20ea9ee44c1ad45dab41d", "status": "processing" },
  "requestId": "..."
}

Poll search completion status. When isComplete is true, fetch hotel results.

{
  "status": true,
  "data": {
    "searchId": "a6784cb565f20ea9ee44c1ad45dab41d",
    "status": "completed",
    "isComplete": true,
    "enginePaginationStatus": "1"
  }
}

Paginated hotel cards for a completed search (10 hotels per page).

Live room rates and hotel detail for one property within a search session.

{
  "status": true,
  "data": {
    "searchId": "...",
    "hotelId": "244012",
    "detail": { },
    "rooms": [ ]
  }
}

Verify selected room keys are still available before checkout.

{
  "searchId": "a6784cb565f20ea9ee44c1ad45dab41d",
  "selectedRoomsList": ["7#17796899391201092", "7#1779689939151349"]
}

{
  "status": true,
  "data": {
    "allAvailable": true,
    "checks": { "7#17796899391201092": true, "7#1779689939151349": true }
  }
}

General booking terms and conditions text for display to end users.

{
  "status": true,
  "data": { "terms": ["Your booking is confirmed...", "..."] }
}

Checkout summary or guest preview in one endpoint.

• Summary — only searchId + selectedRoomsList (or stage: "summary")
• Preview — include contact + rooms with guest details (or stage: "preview")

{
  "searchId": "a6784cb565f20ea9ee44c1ad45dab41d",
  "selectedRoomsList": ["7#17796899391201092"],
  "stage": "preview",
  "contact": {
    "email": "guest@example.com",
    "contactNumber": "6367815547",
    "agencyReference": "AG-454"
  },
  "rooms": [{
    "roomKey": "7#17796899391201092",
    "adults": [{
      "title": "Mr.",
      "firstName": "YASH",
      "lastName": "RATHORE",
      "pan": "DZFPR4916B",
      "panVerified": true
    }],
    "children": [{ "firstName": "Yash", "lastName": "Rathore", "age": 4 }]
  }]
}

Finalize booking. Same body as checkout preview; acceptTerms: true is required.

{
  "status": true,
  "data": {
    "success": true,
    "message": "Booking confirmed",
    "bookingId": "TRP5107",
    "bookingStatusCode": 1,
    "redirectToConfirm": true,
    "redirectToHome": false
  }
}

Full booking detail: hotel, rooms, guests, policies, references.

{
  "status": true,
  "data": {
    "bookingId": "TRP5107",
    "message": "Booking confirmed",
    "status": { "status": "confirmed", "statusCode": 1, "isTerminal": false }
  }
}

Lightweight status for polling after book/confirm.

Preview cancellation penalty and refund (does not cancel).

Cancel an online booking.

Voucher payload when status is confirmed or vouchered.

409 VOUCHER_NOT_AVAILABLE if status not eligible