--- title: "Retrieves a paginated list of bookings and enquiries from the inbox, with optional filtering." method: GET path: "/v1/reservation" tags: ["Reservations"] --- # Retrieves a paginated list of bookings and enquiries from the inbox, with optional filtering. `GET /v1/reservation` Retrieves a paginated list of all bookings and enquiries in the inbox. Supports filtering by status, property, date range, and trash status. ## Query parameters - `offset` integer - `limit` integer - `status` string - `trash` boolean - `propertyId` integer - `periodStart` string, date-time - `periodEnd` string, date-time - `modifiedSince` string, date-time ## Response `200` OK - LodgifyApiPublicReservationsModelsV1PagedResult1BookingViewModel — Returns Paged result sets through the API - `items` LodgifyApiPublicReservationsModelsV1BookingViewModel[], nullable — List of items for this page - `id` integer — Booking or Enquiry Identifier - `type` string, nullable — Defines if is a Booking or a Enquiry - `booking_type` string, nullable — Determines the bookability of this Booking or a Enquiry - `status` string, nullable — Status of the Booking or Enquiry - `source` string, nullable — Source of the booking or enquiry - `source_text` string, nullable — Source text of the booking or enquiry - `guest` LodgifyApiPublicReservationsModelsV1GuestViewModel — Represents detailed information about a guest. - `guest_name` LodgifyApiPublicReservationsModelsV1GuestNameDto — Represents the name details of a guest. - `first_name` string, nullable — The first name of the guest. - `last_name` string, nullable — The last name or surname of the guest. - `full_name` string, nullable — The full name of the guest, combining first and last names. - `name` string, nullable — Deprecated. Use GuestName.FirstName instead. - `external_id` string, nullable — The unique identifier for the guest in external channels (e.g., Airbnb). - `email` string, nullable — The email address of the guest. - `phone_numbers` string[], nullable — A collection of phone numbers associated with the guest. - `phone` string, nullable — Deprecated. Use PhoneNumbers instead. - `locale` string, nullable — The locale or language preference of the guest. - `street_address1` string, nullable — The primary street address of the guest. - `street_address2` string, nullable — The secondary street address of the guest (e.g., apartment or suite number). - `city` string, nullable — The city of the guest's address. - `country_code` string, nullable — The ISO country code of the guest's address. - `postal_code` string, nullable — The postal or zip code of the guest's address. - `state` string, nullable — The state or province of the guest's address. - `id` string, nullable — The unique identifier for the guest. - `country_name` string, nullable — The full name of the country associated with the guest. - `arrival` string, nullable — Booking/Enquiry Arrival Date. In yyyy-MM-dd format - `departure` string, nullable — Booking/Enquiry Departure Date. In yyyy-MM-dd format - `people` integer, nullable — The number of people (if any) the booking or enquiry references - `total_guest_breakdown` LodgifyApiPublicReservationsModelsV12GuestBreakdownDto — The breakdown of guests for the booking or enquiry - `adults` integer — The number of adults - `children` integer — The number of children - `infants` integer — The number of infants - `pets` integer — The number of pets - `property_id` integer, nullable — The property Identifier (if any) the booking or enquiry references - `property_name` string, nullable — The property Name (if any) the booking or enquiry references - `rooms` LodgifyApiPublicReservationsModelsV1BookingRoomTypeViewModel[], nullable — The list of rooms (if any) the booking or enquiry references - `room_type_id` integer — Identifier of the room type - `guest_breakdown` LodgifyApiPublicReservationsModelsV12GuestBreakdownDto, required — The breakdown of guests for the booking or enquiry - `adults` integer — The number of adults - `children` integer — The number of children - `infants` integer — The number of infants - `pets` integer — The number of pets - `people` integer — Deprecated. Map to GuestBreakdown.Adults - `key_code` string, nullable — KeyCode PIN to access to the property rented. - `name` string, nullable — Name of the room type of the property - `created_at` string, date-time — Booking / Enquiry creation Datetime - `is_replied` boolean — bool value indicating if the booking/enquiry has been replied to the renter - `updated_at` string, date-time — Last update datetime - `is_deleted` boolean — Boolean indicating if the booking/enquiry is deleted and stored in the trash - `date_deleted` string, date-time, nullable — If is a deleted booking/enquiry then the datetime of deletion, null otherwise - `total_amount` number, double, nullable — Total amount of the booking/enquiry - `total_paid` number, double — Total amount paid for the booking/enquiry - `amount_to_pay` number, double, nullable — Amount to pay for the booking/enquiry - `thread_uid` string, uuid — Uid of the message thread the booking belongs to - `upgraded_enquiry_id` integer, nullable — If the booking was upgraded from an enquiry, this is the Id of the original enquiry. - `currency` LodgifyApiPublicReservationsModelsV1CurrencyViewModel — Represents currency information used for monetary values. - `id` integer — The unique identifier for the currency. - `code` string, nullable — The ISO currency code (e.g., USD, EUR). - `name` string, nullable — The full name of the currency. - `euro_forex` number, double — The exchange rate relative to the Euro. - `symbol` string, nullable — The symbol associated with the currency (e.g., $, �). - `total` integer — Total number of items - `next` string, nullable — Link to the next resultset. Only useful for Api Access. Empty if is the last page. - `previous` string, nullable — Link to the previous resultset. Only useful for Api Access. Empty if is the first page ## Other responses - `400` — Bad Request - `401` — Unauthorized - `404` — Not Found - `500` — Internal Server Error --- [API](https://skmtc.net/lodgify/apis/lodgify-public-api-v1.md) · [All operations](https://skmtc.net/lodgify/apis/lodgify-public-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lodgify/lodgify-public-api-v1/versions/ddf40757d411/schema)