Search Reservations

get

https://open-api.guesty.com/v1/reservations-reports/reservations/search

Search reservations with flexible filtering, sorting and pagination — and receive the full report enrichments (money, listing, guest, accounting, ...) that the legacy search-reservations endpoint used to surface.

Filters

Filters use bracket notation in the query string:

filter[<field>]=<value> — shorthand (defaults to eq, or implicit in when comma-separated).
filter[<field>][<operator>]=<value> — explicit operator.

Multiple operators on the same field are combined with logical AND, e.g.
filter[checkInDate][gte]=2026-01-01&filter[checkInDate][lt]=2026-02-01 returns reservations checking in during January 2026.

All date/time fields use listing timezone.

Identifier fields (string equality / set membership)

Field	Operators	Notes
`status`	`eq`, `ne`, `in`, `nin`	Comma-separated value implies `in`
`listingId`	`eq`, `in`	Matches the top-level `listingId` on the report (works for both legacy and v3 reservations)
`confirmationCode`	`eq`, `in`	Comma-separated value implies `in`
`source`	`eq`, `in`	e.g. `direct`, `bookingCom`

Date / range fields

Field	Operators	Format	Notes
`checkIn`	`eq`, `gte`, `gt`, `lte`, `lt`	`YYYY-MM-DDTHH:mm:ss` (listing TZ)	Planned arrival datetime
`checkInDate`	`gte`, `gt`, `lte`, `lt`	`YYYY-MM-DD` (listing TZ)	Check-in date with day-boundary semantics. For exact day: `gte=2026-01-15&lt=2026-01-16`
`checkInTime`	`eq`, `gte`, `gt`, `lte`, `lt`	`HH:mm` (listing TZ)	Planned arrival time (string comparison)
`checkOut`	`eq`, `gte`, `gt`, `lte`, `lt`	`YYYY-MM-DDTHH:mm:ss` (listing TZ)	Planned departure datetime
`checkOutDate`	`gte`, `gt`, `lte`, `lt`	`YYYY-MM-DD` (listing TZ)	Check-out date with day-boundary semantics
`checkOutTime`	`eq`, `gte`, `gt`, `lte`, `lt`	`HH:mm` (listing TZ)	Planned departure time (string comparison)
`createdAt`	`eq`, `gte`, `gt`, `lte`, `lt`	ISO 8601 datetime	e.g. `2026-01-01T00:00:00Z`

Sorting

Use the sort query parameter. Prefix the field with - for descending order.
Allowed fields: _id, checkIn, checkOut, createdAt. Default: -_id.

Pagination

Use skip (default 0) and limit (default 25, max 100). The response includes a pagination.hasMore flag.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

skip

number

≥ 0

Defaults to 0

Number of records to skip

limit

number

1 to 100

Defaults to 25

Maximum records to return

sort

string

enum

Defaults to -_id

Sort field. Prefix with - for descending. Allowed: _id, checkIn, checkOut, createdAt

filter[source][in]

string

Reservation source in set (comma-separated). Equivalent to the bare filter[source] shorthand.

filter[source][eq]

string

Reservation source equal to value

filter[source]

string

Reservation source — comma-separated for implicit IN, single value for implicit eq. E.g. direct,bookingCom

filter[confirmationCode][in]

string

Confirmation code in set (comma-separated). Equivalent to the bare filter[confirmationCode] shorthand.

filter[confirmationCode][eq]

string

Confirmation code equal to value

filter[confirmationCode]

string

Confirmation code — comma-separated for implicit IN, single value for implicit eq.

filter[listingId][in]

string

Listing ID in set (comma-separated). Equivalent to the bare filter[listingId] shorthand.

filter[listingId][eq]

string

Listing ID equal to value

filter[listingId]

string

Listing ID — comma-separated for implicit IN, single value for implicit eq.

filter[status][nin]

string

Status not in set (comma-separated)

filter[status][in]

string

Status in set (comma-separated). Equivalent to the bare filter[status] shorthand.

filter[status][ne]

string

Status not equal to value

filter[status][eq]

string

Status equal to value

filter[status]

string

Status — comma-separated for implicit IN, single value for implicit eq. E.g. confirmed,reserved

filter[createdAt][lt]

string

Reservation created strictly before timestamp (ISO 8601)

filter[createdAt][lte]

string

Reservation created on/before timestamp (ISO 8601)

filter[createdAt][gt]

string

Reservation created strictly after timestamp (ISO 8601)

filter[createdAt][gte]

string

Reservation created on/after timestamp (ISO 8601)

filter[createdAt][eq]

string

Reservation created exactly at timestamp (ISO 8601)

filter[checkOutTime][lte]

string

Check-out time on/before (HH:mm, listing TZ)

filter[checkOutTime][gte]

string

Check-out time on/after (HH:mm, listing TZ)

filter[checkOutTime][eq]

string

Check-out time exactly (HH:mm, listing TZ)

filter[checkOutDate][lt]

string

Check-out date strictly before (listing TZ, YYYY-MM-DD)

filter[checkOutDate][lte]

string

Check-out date on/before (listing TZ, YYYY-MM-DD)

filter[checkOutDate][gt]

string

Check-out date strictly after (listing TZ, YYYY-MM-DD)

filter[checkOutDate][gte]

string

Check-out date on/after (listing TZ, YYYY-MM-DD)

filter[checkOut][lt]

string

Check-out strictly before datetime (listing TZ, YYYY-MM-DDTHH:mm:ss)

filter[checkOut][lte]

string

Check-out on/before datetime (listing TZ, YYYY-MM-DDTHH:mm:ss)

filter[checkOut][gt]

string

Check-out strictly after datetime (listing TZ, YYYY-MM-DDTHH:mm:ss)

filter[checkOut][gte]

string

Check-out on/after datetime (listing TZ, YYYY-MM-DDTHH:mm:ss)

filter[checkOut][eq]

string

Check-out exactly at datetime (listing TZ, YYYY-MM-DDTHH:mm:ss)

filter[checkInTime][lte]

string

Check-in time on/before (HH:mm, listing TZ)

filter[checkInTime][gte]

string

Check-in time on/after (HH:mm, listing TZ)

filter[checkInTime][eq]

string

Check-in time exactly (HH:mm, listing TZ)

filter[checkInDate][lt]

string

Check-in date strictly before (listing TZ, YYYY-MM-DD)

filter[checkInDate][lte]

string

Check-in date on/before (listing TZ, YYYY-MM-DD)

filter[checkInDate][gt]

string

Check-in date strictly after (listing TZ, YYYY-MM-DD)

filter[checkInDate][gte]

string

Check-in date on/after (listing TZ, YYYY-MM-DD)

filter[checkIn][lt]

string

Check-in strictly before datetime (listing TZ, YYYY-MM-DDTHH:mm:ss)

filter[checkIn][lte]

string

Check-in on/before datetime (listing TZ, YYYY-MM-DDTHH:mm:ss)

filter[checkIn][gt]

string

Check-in strictly after datetime (listing TZ, YYYY-MM-DDTHH:mm:ss)

filter[checkIn][gte]

string

Check-in on/after datetime (listing TZ, YYYY-MM-DDTHH:mm:ss)

filter[checkIn][eq]

string

Check-in exactly at datetime (listing TZ, YYYY-MM-DDTHH:mm:ss)

Responses

400

Returned when an unsupported filter field, operator, or sort value is provided

500

Indicates server-side error while processing the request

Language

Credentials

Header

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Success