Little Hotelier API

POST https://cotlet.dev/api/v1/little-hotelier/list_reservations

Searches reservations like the Reservations screen. Date type can be check-in, check-out or booked on, and status can be confirmed, checked in, checked out or cancelled. Each row has status, guest name, reference, source, occupants, dates, room, total and outstanding amount. Reservations without an assigned room show no room. Pass next_cursor back as cursor for the next page.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/little-hotelier/list_reservations \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date_type":"check_in","from":"2026-10-12","to":"2026-10-13","status":"confirmed"}'

result = client.call("little-hotelier", "list_reservations", {"date_type":"check_in","from":"2026-10-12","to":"2026-10-13","status":"confirmed"})

const result = await cotlet.call('little-hotelier', 'list_reservations', {"date_type":"check_in","from":"2026-10-12","to":"2026-10-13","status":"confirmed"});

cotlet call little-hotelier list_reservations --data '{"date_type":"check_in","from":"2026-10-12","to":"2026-10-13","status":"confirmed"}'

Example response

{
  "reservations": [
    {
      "reservation_id": "LH48213",
      "status": "confirmed",
      "guest": "Marta Kowal",
      "source": "Booking.com",
      "occupants": "2 adults",
      "check_in": "2026-10-12",
      "check_out": "2026-10-14",
      "booked": "2026-09-02",
      "room": "Double 3",
      "total": "240.00",
      "outstanding": "240.00",
      "currency": "EUR"
    },
    {
      "reservation_id": "LH48230",
      "status": "confirmed",
      "guest": "Liam Byrne",
      "source": "Direct Booking",
      "occupants": "1 adult",
      "check_in": "2026-10-12",
      "check_out": "2026-10-13",
      "booked": "2026-10-05",
      "room": null,
      "total": "95.00",
      "outstanding": "0.00",
      "currency": "EUR"
    }
  ],
  "next_cursor": null
}

POST https://cotlet.dev/api/v1/little-hotelier/get_reservation

Returns one reservation with stay dates, room and rate, occupants, guest comments, internal notes, invoice lines and recorded payments. Card numbers are never returned. Use it after list_reservations when you need the detail behind one outstanding amount.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/little-hotelier/get_reservation \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"reservation_id":"reservation_8c41d2"}'

result = client.call("little-hotelier", "get_reservation", {"reservation_id":"reservation_8c41d2"})

const result = await cotlet.call('little-hotelier', 'get_reservation', {"reservation_id":"reservation_8c41d2"});

cotlet call little-hotelier get_reservation --data '{"reservation_id":"reservation_8c41d2"}'

Example response

{
  "reservation_id": "LH48213",
  "status": "confirmed",
  "source": "Booking.com",
  "guest": {
    "name": "Marta Kowal",
    "email": "marta@example.com",
    "arrival_time": "18:00"
  },
  "stay": {
    "check_in": "2026-10-12",
    "check_out": "2026-10-14",
    "nights": 2,
    "adults": 2,
    "children": 0
  },
  "room": "Double 3",
  "room_rate": "Double Room, Standard Rate",
  "guest_comments": "Late arrival, around 18:00.",
  "notes": [],
  "invoice": {
    "lines": [
      {
        "description": "Double Room, 2 nights",
        "amount": "240.00"
      }
    ],
    "total": "240.00",
    "paid": "0.00",
    "outstanding": "240.00",
    "currency": "EUR"
  },
  "payments": []
}

POST https://cotlet.dev/api/v1/little-hotelier/list_room_rates

Returns your room types with their rooms and room rates. Each rate says whether it is derived from another rate, because derived rates cannot be edited directly. Use the IDs it returns in get_inventory, update_rates, update_restrictions and create_room_closure.

Parameters

No parameters.

Request

curl -X POST https://cotlet.dev/api/v1/little-hotelier/list_room_rates \
  -H "Authorization: Bearer $COTLET_API_KEY"

result = client.call("little-hotelier", "list_room_rates")

const result = await cotlet.call('little-hotelier', 'list_room_rates');

cotlet call little-hotelier list_room_rates

Example response

{
  "room_types": [
    {
      "room_type": "Double Room",
      "rooms": [
        {
          "room_id": "rm_3",
          "name": "Double 3"
        },
        {
          "room_id": "rm_4",
          "name": "Double 4"
        }
      ],
      "room_rates": [
        {
          "room_rate_id": "rr_20417",
          "name": "Standard Rate",
          "derived_from": null
        },
        {
          "room_rate_id": "rr_20418",
          "name": "Non-refundable",
          "derived_from": "rr_20417"
        }
      ]
    }
  ]
}

POST https://cotlet.dev/api/v1/little-hotelier/get_inventory

Returns the inventory grid for a date range: availability, rate, min and max stay, CTA, CTD and whether channels are closed, one row per room rate and date. Availability is calculated by Little Hotelier from your rooms, bookings and closures. Read it before update_rates to see what will change.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/little-hotelier/get_inventory \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"from":"2026-10-01","to":"2026-10-01"}'

result = client.call("little-hotelier", "get_inventory", {"from":"2026-10-01","to":"2026-10-01"})

const result = await cotlet.call('little-hotelier', 'get_inventory', {"from":"2026-10-01","to":"2026-10-01"});

cotlet call little-hotelier get_inventory --data '{"from":"2026-10-01","to":"2026-10-01"}'

Example response

{
  "room_rates": [
    {
      "room_rate_id": "rr_20417",
      "name": "Double Room, Standard Rate",
      "days": [
        {
          "date": "2026-12-04",
          "available": 2,
          "rate": "120.00",
          "min_stay": 1,
          "max_stay": null,
          "cta": false,
          "ctd": false,
          "channels_closed": false
        },
        {
          "date": "2026-12-05",
          "available": 1,
          "rate": "120.00",
          "min_stay": 1,
          "max_stay": null,
          "cta": false,
          "ctd": false,
          "channels_closed": false
        }
      ]
    }
  ],
  "currency": "EUR"
}

POST https://cotlet.dev/api/v1/little-hotelier/get_statistics

Runs the Front Desk Statistics report for a date range. It returns total, closed, occupied and unoccupied room nights, occupancy, length of stay, lead time, average revenue per booking, ADR, RevPAR and the value of cancelled reservations. Occupancy, RevPAR and the room night counts exist only when searching by stay date. Closed room nights are taken out of the occupancy base.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/little-hotelier/get_statistics \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"from":"2026-10-01","to":"2026-10-01"}'

result = client.call("little-hotelier", "get_statistics", {"from":"2026-10-01","to":"2026-10-01"})

const result = await cotlet.call('little-hotelier', 'get_statistics', {"from":"2026-10-01","to":"2026-10-01"});

cotlet call little-hotelier get_statistics --data '{"from":"2026-10-01","to":"2026-10-01"}'

Example response

{
  "from": "2026-09-01",
  "to": "2026-09-30",
  "search_by": "stay_date",
  "include_tax": false,
  "currency": "EUR",
  "total_room_nights": 240,
  "closed_room_nights": 7,
  "occupied_room_nights": 160,
  "unoccupied_room_nights": 73,
  "occupancy_pct": 68.7,
  "length_of_stay": 2.5,
  "lead_time_days": 21,
  "average_revenue_per_booking": "275.00",
  "adr": "110.00",
  "revpar": "75.54",
  "cancelled_value": "420.00"
}

POST https://cotlet.dev/api/v1/little-hotelier/get_booking_performance

Reads the Insights Booking performance report. It returns reservations after cancellations, room nights, ADR, average length of stay, lead time and cancelled reservations, with room revenue and room nights per channel, including your booking engine. Some channels record no revenue on a reservation: those count toward room nights but not ADR. Multi-currency bookings are converted to your default currency.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/little-hotelier/get_booking_performance \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"from":"2026-10-01","to":"2026-10-01"}'

result = client.call("little-hotelier", "get_booking_performance", {"from":"2026-10-01","to":"2026-10-01"})

const result = await cotlet.call('little-hotelier', 'get_booking_performance', {"from":"2026-10-01","to":"2026-10-01"});

cotlet call little-hotelier get_booking_performance --data '{"from":"2026-10-01","to":"2026-10-01"}'

Example response

{
  "from": "2026-09-01",
  "to": "2026-09-30",
  "date_basis": "booked_on",
  "currency": "EUR",
  "reservations": 64,
  "room_nights": 160,
  "adr": "110.00",
  "avg_length_of_stay": 2.5,
  "avg_lead_time_days": 21,
  "cancelled_reservations": 3,
  "channels": [
    {
      "channel": "Booking.com",
      "reservations": 32,
      "room_nights": 80,
      "room_revenue": "8800.00"
    },
    {
      "channel": "Direct Booking",
      "reservations": 19,
      "room_nights": 48,
      "room_revenue": "5280.00"
    },
    {
      "channel": "Airbnb",
      "reservations": 13,
      "room_nights": 32,
      "room_revenue": "3520.00"
    }
  ]
}

POST https://cotlet.dev/api/v1/little-hotelier/export_report

Returns a Front Desk report as rows, the same data as the report's CSV export. A single report cannot span more than 365 days. Use get_statistics for the Statistics report.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/little-hotelier/export_report \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"report":"check_in","from":"2026-10-01","to":"2026-10-01"}'

result = client.call("little-hotelier", "export_report", {"report":"check_in","from":"2026-10-01","to":"2026-10-01"})

const result = await cotlet.call('little-hotelier', 'export_report', {"report":"check_in","from":"2026-10-01","to":"2026-10-01"});

cotlet call little-hotelier export_report --data '{"report":"check_in","from":"2026-10-01","to":"2026-10-01"}'

Example response

{
  "report": "daily_transactions",
  "from": "2026-10-01",
  "to": "2026-10-07",
  "currency": "EUR",
  "rows": [
    {
      "date": "2026-10-05",
      "reservation_id": "LH48230",
      "description": "Deposit",
      "amount": "30.00"
    },
    {
      "date": "2026-10-06",
      "reservation_id": "LH48199",
      "description": "Breakfast extra",
      "amount": "18.00"
    }
  ]
}

POST https://cotlet.dev/api/v1/little-hotelier/list_conversations

Lists Messaging hub conversations, with the guest, the linked reservation, the channel and the last message. WhatsApp, Airbnb and Booking.com conversations are listed. Each row says whether a free-form reply is possible now: WhatsApp allows it within 24 hours of the guest's last message.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/little-hotelier/list_conversations \
  -H "Authorization: Bearer $COTLET_API_KEY"

result = client.call("little-hotelier", "list_conversations")

const result = await cotlet.call('little-hotelier', 'list_conversations');

cotlet call little-hotelier list_conversations

Example response

{
  "conversations": [
    {
      "conversation_id": "cv_5521",
      "channel": "whatsapp",
      "guest": "Marta Kowal",
      "reservation_id": "LH48213",
      "last_message": "Can we check in late, around 21:30?",
      "last_message_at": "2026-10-11T08:12:00Z",
      "free_form_reply_open": true
    }
  ]
}

POST https://cotlet.dev/api/v1/little-hotelier/create_reservation

Creates a Front Desk reservation with a booking reference starting with LH. It holds the room and updates availability on your connected channels. Without room_id the booking is unallocated but still reduces availability. Little Hotelier does not email a confirmation for manual reservations, and neither does this tool. Card details are not accepted. By default you confirm each call; you can switch that off for this tool.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/little-hotelier/create_reservation \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"check_in":"2026-10-01","check_out":"2026-10-01","room_rate_id":"room_rate_8c41d2","guest":"guest","adults":1}'

result = client.call("little-hotelier", "create_reservation", {"check_in":"2026-10-01","check_out":"2026-10-01","room_rate_id":"room_rate_8c41d2","guest":"guest","adults":1})

const result = await cotlet.call('little-hotelier', 'create_reservation', {"check_in":"2026-10-01","check_out":"2026-10-01","room_rate_id":"room_rate_8c41d2","guest":"guest","adults":1});

cotlet call little-hotelier create_reservation --data '{"check_in":"2026-10-01","check_out":"2026-10-01","room_rate_id":"room_rate_8c41d2","guest":"guest","adults":1}'

Example response

{
  "reservation_id": "LH48311",
  "status": "confirmed",
  "room": null,
  "check_in": "2026-11-20",
  "check_out": "2026-11-22",
  "total": "240.00",
  "currency": "EUR"
}

POST https://cotlet.dev/api/v1/little-hotelier/update_reservation_status

Sets a reservation to confirmed, checked_in or checked_out, like the status drop-down on the reservation. Checking out marks the room as needing cleaning and bookable again. It reaches no guest and one more call sets the status back, so it runs without asking first. Each reservation is changed on its own.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/little-hotelier/update_reservation_status \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"reservation_id":"reservation_8c41d2","status":"confirmed"}'

result = client.call("little-hotelier", "update_reservation_status", {"reservation_id":"reservation_8c41d2","status":"confirmed"})

const result = await cotlet.call('little-hotelier', 'update_reservation_status', {"reservation_id":"reservation_8c41d2","status":"confirmed"});

cotlet call little-hotelier update_reservation_status --data '{"reservation_id":"reservation_8c41d2","status":"confirmed"}'

Example response

{
  "reservation_id": "LH48213",
  "status": "checked_in"
}

POST https://cotlet.dev/api/v1/little-hotelier/cancel_reservation

Cancels one Confirmed reservation created in Front Desk. Channel (OTA) reservations are cancelled by the guest on the channel, and Direct Booking reservations under Direct Booking, so the call fails for them. Checked-in and checked-out reservations need their status changed first. A cancellation is permanent. The room becomes available and cancelled reservations stay in the Reservations list. Check your cancellation policy for penalties first. By default you confirm each call; you can switch that off for this tool.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/little-hotelier/cancel_reservation \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"reservation_id":"reservation_8c41d2"}'

result = client.call("little-hotelier", "cancel_reservation", {"reservation_id":"reservation_8c41d2"})

const result = await cotlet.call('little-hotelier', 'cancel_reservation', {"reservation_id":"reservation_8c41d2"});

cotlet call little-hotelier cancel_reservation --data '{"reservation_id":"reservation_8c41d2"}'

Example response

{
  "reservation_id": "LH48311",
  "status": "cancelled"
}

POST https://cotlet.dev/api/v1/little-hotelier/update_rates

Sets the base rate of one or more room rates over a date range, optionally on chosen weekdays, like Bulk Update in the inventory grid. Derived rates cannot be edited and come back in skipped. A rate below the property minimum does not save. Channels receive the change within their update period. By default you confirm each call; you can switch that off for this tool.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/little-hotelier/update_rates \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"room_rate_ids":["rr_20417"],"from":"2026-12-01","to":"2026-12-31","rate":"140.00","days_of_week":["fri","sat"]}'

result = client.call("little-hotelier", "update_rates", {"room_rate_ids":["rr_20417"],"from":"2026-12-01","to":"2026-12-31","rate":"140.00","days_of_week":["fri","sat"]})

const result = await cotlet.call('little-hotelier', 'update_rates', {"room_rate_ids":["rr_20417"],"from":"2026-12-01","to":"2026-12-31","rate":"140.00","days_of_week":["fri","sat"]});

cotlet call little-hotelier update_rates --data '{"room_rate_ids":["rr_20417"],"from":"2026-12-01","to":"2026-12-31","rate":"140.00","days_of_week":["fri","sat"]}'

Example response

{
  "status": "updated",
  "room_rates": 1,
  "dates": 8,
  "rate": "140.00",
  "currency": "EUR",
  "skipped": []
}

POST https://cotlet.dev/api/v1/little-hotelier/update_restrictions

Sets min_stay, max_stay, cta, ctd, close_channels and close_website for room rates over a date range, like Bulk Update. close_channels stops sales on all connected channels and your booking engine but leaves room availability unchanged. A channel that does not support a restriction ignores it. By default you confirm each call; you can switch that off for this tool.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/little-hotelier/update_restrictions \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"room_rate_ids":["rr_20417"],"from":"2026-12-30","to":"2026-12-31","restrictions":{"min_stay":2}}'

result = client.call("little-hotelier", "update_restrictions", {"room_rate_ids":["rr_20417"],"from":"2026-12-30","to":"2026-12-31","restrictions":{"min_stay":2}})

const result = await cotlet.call('little-hotelier', 'update_restrictions', {"room_rate_ids":["rr_20417"],"from":"2026-12-30","to":"2026-12-31","restrictions":{"min_stay":2}});

cotlet call little-hotelier update_restrictions --data '{"room_rate_ids":["rr_20417"],"from":"2026-12-30","to":"2026-12-31","restrictions":{"min_stay":2}}'

Example response

{
  "status": "updated",
  "room_rates": 1,
  "dates": 4,
  "restrictions": {
    "min_stay": 2
  },
  "skipped": []
}

POST https://cotlet.dev/api/v1/little-hotelier/create_room_closure

Closes rooms or whole room types for a date range, like Room Closure on the Front Desk Calendar. The end date is included. Availability sent to channels and your booking engine drops, and the room shows in red on the Calendar. A closure is not a stop sell. It does not move guests who already booked those dates. By default you confirm each call; you can switch that off for this tool.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/little-hotelier/create_room_closure \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"room_ids":["room ids"],"from":"2026-10-01","to":"2026-10-01"}'

result = client.call("little-hotelier", "create_room_closure", {"room_ids":["room ids"],"from":"2026-10-01","to":"2026-10-01"})

const result = await cotlet.call('little-hotelier', 'create_room_closure', {"room_ids":["room ids"],"from":"2026-10-01","to":"2026-10-01"});

cotlet call little-hotelier create_room_closure --data '{"room_ids":["room ids"],"from":"2026-10-01","to":"2026-10-01"}'

Example response

{
  "closure_id": "cl_7731",
  "status": "closed",
  "room_ids": [
    "rm_4"
  ],
  "from": "2026-10-12",
  "to": "2026-10-18",
  "nights": 7,
  "description": "Leak repair"
}

POST https://cotlet.dev/api/v1/little-hotelier/reply_to_guest

Sends a reply in a WhatsApp or Airbnb conversation in the Messaging hub, under your property. WhatsApp free-form replies work within 24 hours of the guest's last message; later, Little Hotelier requires a template. Airbnb free-form replies work only after a scheduled message went out and the guest replied. By default you confirm each call; you can switch that off for this tool.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/little-hotelier/reply_to_guest \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"conversation_id":"cv_5521","body":"Yes, late check-in at 21:30 is fine. Reception is open until 22:00."}'

result = client.call("little-hotelier", "reply_to_guest", {"conversation_id":"cv_5521","body":"Yes, late check-in at 21:30 is fine. Reception is open until 22:00."})

const result = await cotlet.call('little-hotelier', 'reply_to_guest', {"conversation_id":"cv_5521","body":"Yes, late check-in at 21:30 is fine. Reception is open until 22:00."});

cotlet call little-hotelier reply_to_guest --data '{"conversation_id":"cv_5521","body":"Yes, late check-in at 21:30 is fine. Reception is open until 22:00."}'

Example response

{
  "conversation_id": "cv_5521",
  "message_id": "msg_90417",
  "status": "sent",
  "channel": "whatsapp"
}