API Documentation

curl -X POST https://locktrip.com/mcp/tools/search_location \
  -H "Content-Type: application/json" \
  -d '{"query": "Paris"}'

# Response (200 OK):
{
  "locations": [
    {
      "id": "5f078e431fd614748f9037f9",
      "name": "Paris, France",
      "country": "",
      "type": "CITY",
      "fullName": "Paris, France"
    },
    {
      "id": "5f080b92b8f3040a9045c3e8",
      "name": "Disneyland Paris, Boulevard de Parc, Coupvray, France",
      "country": "",
      "type": "CITY",
      "fullName": "Disneyland Paris, Boulevard de Parc, Coupvray, France"
    }
  ],
  "totalCount": 10
}

curl -X POST https://locktrip.com/mcp/tools/get_search_results \
  -H "Content-Type: application/json" \
  -d '{
    "searchKey": "47de06e3262ea3822bdc384a04470783",
    "page": 0,
    "size": 2
  }'

# Response (200 OK):
{
  "hotels": [
    {
      "hotelId": "4703420",
      "name": "Premiere Classe Boissy Saint Leger",
      "starRating": 1,
      "address": "P.A De La Haie Griselle 4 Rue Pompadour, Boissy-Saint-Leger",
      "latitude": 48.759967,
      "longitude": 2.501443,
      "images": [
        "https://imagecontent.net/images/full/5a0d94a0-5f7e-4e4e-b457-5e0673a96a95.jpeg"
      ],
      "amenities": ["Family rooms", "Free Wifi", "Parking", "Air conditioning"],
      "minPrice": 71.51,
      "originalPrice": 71.51,
      "currency": "EUR",
      "discountScore": 0,
      "quality": 0.19,
      "reviewScore": 2.5,
      "reviewCount": null,
      "hasFreeCancellation": false,
      "isRefundable": false,
      "refundableUntil": null,
      "payment": "Cash",
      "distance": 15.32,
      "boardType": null,
      "availableMealTypes": []
    }
  ],
  "totalCount": 2403,
  "page": 1,
  "pageSize": 2,
  "hasMore": true,
  "searchStatus": "COMPLETED"
}

curl -X POST https://locktrip.com/mcp/tools/get_hotel_details \
  -H "Content-Type: application/json" \
  -d '{"hotelId": 4384127}'

# Response (200 OK):
{
  "hotel": {
    "id": 4384127,
    "name": "Premiere Classe Plaisir",
    "country": "France",
    "city": "Plaisir",
    "star": 1,
    "address": "Za De Sainte Apolline Rue Des Poiriers",
    "latitude": 48.7987,
    "longitude": 1.9545,
    "description": "<h2>Hotel Details</h2><p>Property Location...</p>",
    "phone": null,
    "hotelPhotos": [
      {"url": "/gmx/full/d174a039-ebf9-4e42-8b42-5e31a6950b0e.jpeg"}
    ],
    "reviews": {
      "scoreSummary": 0,
      "reviewsCount": 0,
      "keyWords": []
    },
    "hotelAmenities": [
      {
        "hotelId": 4384127,
        "categoryName": "Hotel Facilities & Services",
        "features": [
          {"name": "Free Wifi"},
          {"name": "Parking"},
          {"name": "24 Hour Front Desk"}
        ]
      }
    ]
  }
}

curl -X POST https://locktrip.com/mcp/tools/guest_login \
  -H "Content-Type: application/json" \
  -d '{"email": "[email protected]"}'

# Response (200 OK):
{
  "token": "eyJhbGciOiJIUzUxMiJ9...",
  "userId": 413900,
  "email": "[email protected]",
  "isNewUser": true
}

curl -X POST https://locktrip.com/mcp/tools/prepare_booking \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer eyJhbGciOiJIUzUxMiJ9..." \
  -d '{
    "quoteId": "3e242771-1c15-4356-9a3b-1cd4bfc6d9fc_4384127",
    "rooms": [{
      "roomIndex": 0,
      "guests": [
        {"firstName": "John", "lastName": "Smith", "title": "Mr",
         "email": "[email protected]", "phone": "+1234567890",
         "isLeadGuest": true},
        {"firstName": "Jane", "lastName": "Smith", "title": "Mrs"}
      ]
    }],
    "contactPerson": {
      "firstName": "John",
      "lastName": "Smith",
      "email": "[email protected]",
      "phone": "+1234567890"
    }
  }'

# Response (200 OK):
{
  "preparedBookingId": "69a2b7540a93415a4b4dbf13",
  "bookingInternalId": "69a2b7540a93415a4b4dbf13",
  "price": 71.34,
  "currency": "EUR",
  "payment": "Cash",
  "discount": {"amount": 0, "currency": "EUR"},
  "taxes": [
    {
      "feeTitle": "Taxes and Fees",
      "value": "1.59",
      "currency": "EUR",
      "isIncludedInPrice": true
    },
    {
      "feeTitle": "Taxes and Fees",
      "value": "4.50",
      "currency": "EUR",
      "isIncludedInPrice": false
    }
  ],
  "essentialInformation": [
    "CheckIn instructions: ...",
    "Mandatory fees: ...",
    "Know before you go: ..."
  ]
}

curl -X POST https://locktrip.com/mcp/tools/create_checkout \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer eyJhbGciOiJIUzUxMiJ9..." \
  -d '{
    "bookingId": "69a2b7540a93415a4b4dbf13",
    "currency": "EUR"
  }'

# Response (200 OK):
{
  "checkoutUrl": "https://checkout.revolut.com/pay/abc123...",
  "checkoutToken": "rev_tok_abc123...",
  "expiresInMinutes": 20,
  "message": "Payment checkout link created. Share this URL with the user to complete payment."
}

curl -X POST https://locktrip.com/mcp/tools/list_bookings \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer eyJhbGciOiJIUzUxMiJ9..." \
  -d '{"type": "UPCOMING"}'

# Response (200 OK):
{
  "bookings": [
    {
      "bookingId": "69a2b7540a93415a4b4dbf13",
      "bookingReferenceId": "LT-2026-AB12CD",
      "hotelName": "Premiere Classe Plaisir",
      "hotelCity": "Plaisir",
      "checkIn": "2026-04-15",
      "checkOut": "2026-04-17",
      "status": "DONE",
      "totalPrice": 71.34,
      "currency": "EUR",
      "guestName": "John Smith",
      "roomCount": 1,
      "createdAt": "2026-02-28T09:35:00.000Z",
      "hotelPhoto": "https://imagecontent.net/images/full/d174a039.jpeg"
    }
  ],
  "totalCount": 1,
  "page": 0,
  "pageSize": 10
}

# Step 1: Preview cancellation (dry run)
curl -X POST https://locktrip.com/mcp/tools/cancel_booking \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer eyJhbGciOiJIUzUxMiJ9..." \
  -d '{
    "bookingId": "69a2b7540a93415a4b4dbf13",
    "confirmed": false
  }'

# Response (200 OK):
{
  "success": false,
  "message": "Cancellation not confirmed. Set confirmed=true to proceed with cancellation."
}

# Step 2: Execute cancellation
curl -X POST https://locktrip.com/mcp/tools/cancel_booking \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer eyJhbGciOiJIUzUxMiJ9..." \
  -d '{
    "bookingId": "69a2b7540a93415a4b4dbf13",
    "confirmed": true,
    "reason": "Change of plans"
  }'

# Response (200 OK):
{
  "success": true,
  "message": "Booking cancelled successfully"
}