B2B GraphQL API Documentation

query LocationSearch($query: String!) {
  locationSearch(query: $query) {
    locationData
  }
}

{
  "data": {
    "locationSearch": {
      "locationData": [
        {
          "id": "645f64dace586e4a12d943ed",
          "externalId": "ChIJoQ8Q6NNB0S0RkOYkS7EPkSQ",
          "type": "administrative_area_level_1",
          "query": "Bali, Indonesia"
        },
        {
          "id": "6089739c76290b7c193c17b6",
          "type": "locality",
          "query": "Kuta, Badung Regency, Bali, Indonesia"
        },
        {
          "id": "645f64dace586e4a12d943ed_5879110",
          "displayName": "The Bali Bill Villa",
          "type": "Apartment",
          "score": 28.49
        }
      ]
    }
  }
}

query HotelSearchResults($input: SearchResultsInput!) {
  hotelSearchResults(input: $input) {
    results {
      externalId
      name
      star
      address
      latitude
      longitude
      price
      lastBestPrice
      discountScore
      distance
      boardType
      payment
      quality
      reviewsScore
      hasFreeCancellationOption
      refundability
      refundableUntil
      availableBoards
      reviews { scoreSummary reviewsCount }
      hotelPhoto { url }
      features
    }
    totalResults
    page
    size
    hasNextPage
    isResultCompleted
    isSearchFinished
  }
}

{
  "data": {
    "hotelSearchResults": {
      "results": [
        {
          "externalId": 5948584,
          "name": "The Kayon Jungle Resort",
          "star": 5,
          "address": "Br. Bresela, Payangan, Gianyar",
          "latitude": -8.4231,
          "longitude": 115.2134,
          "price": 127.50,
          "lastBestPrice": 195.00,
          "discountScore": 35,
          "distance": 12.4,
          "boardType": "Breakfast",
          "payment": "Cash",
          "quality": 2.4,
          "reviewsScore": 9.2,
          "hasFreeCancellationOption": true,
          "refundability": true,
          "refundableUntil": "2027-08-20T00:00:00Z",
          "availableBoards": ["Room Only", "Breakfast", "Half Board"],
          "reviews": { "scoreSummary": 9.2, "reviewsCount": 1247 },
          "hotelPhoto": { "url": "https://imagecontent.net/images/full/hotel-5948584.jpeg" },
          "features": ["Pool", "Spa", "WiFi", "Restaurant", "Gym"]
        }
      ],
      "totalResults": 2089,
      "page": 1,
      "size": 100,
      "hasNextPage": true,
      "isResultCompleted": true,
      "isSearchFinished": true
    }
  }
}

await sleep(2000); // MANDATORY 2s wait

for (let attempt = 0; attempt < 30; attempt++) {
  const result = await graphql(QUERY, {
    input: { searchKey, page: 1, size: 100 }
  });
  if (result.hotelSearchResults.isResultCompleted) {
    return result.hotelSearchResults.results;
  }
  await sleep(1000);
}

query HotelCancellationPolicies(
  $searchKey: String!
  $hotelId: String!
  $packageIds: [String!]!
) {
  hotelCancellationPolicies(
    searchKey: $searchKey
    hotelId: $hotelId
    packageIds: $packageIds
  ) {
    packageId
    fallbackPolicy
    cancellations {
      nonRefundable
      boardType
      roomType
      originalName
      canxFees {
        amount { amt }
        from
      }
    }
  }
}

{
  "data": {
    "hotelCancellationPolicies": [
      {
        "packageId": "73513d6a-b452-449b-ae29-9797790ed569",
        "fallbackPolicy": null,
        "cancellations": [{
          "nonRefundable": false,
          "boardType": "Breakfast",
          "roomType": "Deluxe Room",
          "originalName": "Deluxe Room with Garden View - Breakfast Included",
          "canxFees": [
            { "amount": { "amt": 0 },      "from": 1724284800000 },
            { "amount": { "amt": 127.50 }, "from": 1724457600000 },
            { "amount": { "amt": 255.00 }, "from": 1724544000000 }
          ]
        }]
      }
    ]
  }
}

mutation ConfirmB2bBooking($bookingConfirmInput: BookingConfirmInput!) {
  confirmB2bBooking(bookingConfirmInput: $bookingConfirmInput) {
    accepted
    message
    serviceUnavailable   # see the note below before adding this line
  }
}

{
  "bookingConfirmInput": {
    "bookingInternalId": "69a2b7540a93415a4b4dbf13",
    "quoteId": "3e242771-1c15-4356-9a3b-1cd4bfc6d9fc_4384127",
    "paymentMethod": "CREDIT_LINE"
  }
}

# Success
{
  "data": {
    "confirmB2bBooking": {
      "accepted": true,
      "message": null
    }
  }
}

# Failure — account not B2B
{
  "data": {
    "confirmB2bBooking": {
      "accepted": false,
      "message": "User is not b2b user"
    }
  }
}

# Failure — credit line exhausted (a VERDICT: will not change on retry)
{
  "data": {
    "confirmB2bBooking": {
      "accepted": false,
      "message": "Insufficient credit line.",
      "serviceUnavailable": null
    }
  }
}

# Failure — our credit line service was unreachable (NOT a credit decision)
{
  "data": {
    "confirmB2bBooking": {
      "accepted": false,
      "message": "The credit line service is temporarily unavailable, ...",
      "serviceUnavailable": true
    }
  }
}

query GetBookingDetails($bookingId: String!) {
  getBookingDetails(bookingId: $bookingId) {
    success
    data {
      bookingId
      bookingReferenceId
      providerReference
      status
      hotel { id name address city country phone email starRating }
      checkIn
      checkOut
      rooms {
        roomName
        mealType
        guests { firstName lastName }
        price
      }
      contactPerson { firstName lastName email phone }
      totalPrice
      currency
      paymentStatus
      cancellationPolicy {
        isRefundable
        freeCancellationUntil
        fees { fromDate amount currency }
      }
      specialRequests
      createdAt
      confirmedAt
    }
  }
}

curl "https://users.locktrip.com/api/b2b/credit-line/statement?from=2026-07-01&to=2026-07-31" \
  -H "Authorization: Bearer eyJhbGciOiJIUzUxMiJ9..."

# Response (200 OK) — abridged:
{
  "success": true,
  "account":  { "name": "...", "currency": "EUR", "creditLimit": 10600, "periodType": "..." },
  "balance": { "due": 498.82, "pending": 8204.97, "availableCredit": 1896.21,
               "creditRemaining": 0, "evaluatedAt": "2026-10-01T12:00:00.000Z", "source": "fifo-realtime" },
  "balanceAsRecorded": { "currentDebt": 498.82, "pendingDebt": 8204.97, "availableCredit": 1896.21 },  // deprecated alias
  "period": { "from": "2026-07-01", "to": "2026-07-31", "excludedWithoutCancellationDate": { "count": 0, "amount": 0 } },
  "bookingsMatured": { "label": "...", "rows": [ ... ], "count": 3, "grossTotal": 498.82 },
  "bookingsPending": { "label": "...", "rows": [ ... ], "count": 19, "grossTotal": 8204.97 },
  "paymentsReceived": { "label": "...", "rows": [ ... ], "count": 0, "totalToDate": 0, "since": "2026-01-01T00:00:00.000Z" }
}

curl -X POST https://users.locktrip.com/api/b2b/credit-line/settlement \
  -H "Authorization: Bearer eyJhbGciOiJIUzUxMiJ9..." \
  -H "Content-Type: application/json" \
  -d '{"amount": 2500.00}'

# Response (201 Created):
{
  "success": true,
  "settlement": {
    "reference": "CL5I5ONKXR1FAMH", "status": "AWAITING_FUNDS",
    "amount": 2500, "currency": "EUR",
    "createdAt": "...", "expiresAt": "...",
    "receivedAmount": null, "receivedAt": null, "recordedAt": null
  },
  "bankTransfer": {
    "beneficiary": "...", "iban": "...", "bic": "...",
    "amount": 2500, "currency": "EUR", "reference": "CL5I5ONKXR1FAMH"
  },
  "notice": "Anything you send above your outstanding balance is held as credit against your future bookings — it is not refunded."
}

curl https://users.locktrip.com/api/b2b/credit-line/settlements \
  -H "Authorization: Bearer eyJhbGciOiJIUzUxMiJ9..."

# Response (200 OK):
{ "success": true, "settlements": [ ... ], "payable": [ ... ],
  "bank": { "beneficiary": "...", "iban": "...", "bic": "..." },
  "notice": "..." }

curl -X POST https://users.locktrip.com/api/b2b/credit-line/settlement/CL5I5ONKXR1FAMH/cancel \
  -H "Authorization: Bearer eyJhbGciOiJIUzUxMiJ9..."

# Response (200 OK):
{ "success": true, "settlement": { "reference": "CL5I5ONKXR1FAMH", "status": "CANCELLED", ... } }

Date format:       DD/MM/YYYY  (e.g. "23/08/2027")
Page numbers:      1-based (start with page 1)
Completion field:  isResultCompleted === true
hotelId type:      NUMBER for getHotelRooms, STRING for hotelCancellationPolicies
packageId:         quoteId.split('_')[0]
Guest structure:   rooms[].adults[] with title, firstName, lastName
Guest count:       Must match search exactly
First poll wait:   2+ seconds mandatory
Search time:       15–30 seconds typical
Session lifetime:  ~30 minutes

Flow: locationSearch → hotelSearch → WAIT 2s → hotelSearchResults
      → getHotelRooms → hotelCancellationPolicies
      → hotelBookingPrepare → confirmB2bBooking

Manage: getUserBookings → getBookingDetails → cancelBookingRequest