Search Reservations

get

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

Search reservations with flexible filtering, sorting and pagination.

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[checkIn][gte]=2026-01-01&filter[checkIn][lt]=2026-02-01 returns reservations checking in during January 2026.

Identifier fields (string equality / set membership)

Field	Operators	Notes
`status`	`eq`, `ne`, `in`, `nin`	Comma-separated value implies `in`
`listingId`	`eq`, `in`	Matches `unitId` or `unitTypeId` on the first stay segment
`confirmationCode`	`eq`, `in`	Comma-separated value implies `in`
`source`	`eq`, `in`	e.g. `airbnb`, `booking.com`, `manual`

Date / range fields (operator required)

Field	Operators	Format
`checkIn`	`eq`, `gte`, `gt`, `lte`, `lt`	Localized date `YYYY-MM-DD`, e.g. `2026-01-15`
`checkOut`	`eq`, `gte`, `gt`, `lte`, `lt`	Localized date `YYYY-MM-DD`
`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]

string

Reservation source (comma-separated for implicit IN). E.g. airbnb,booking.com

filter[confirmationCode]

string

Confirmation code (comma-separated for implicit IN)

filter[listingId]

string

Listing ID (comma-separated for implicit IN). Matches unitId or unitTypeId on first stay.

filter[status][ne]

string

Status not equal to value

filter[status]

string

Status (comma-separated for implicit IN). E.g. confirmed,reserved

filter[createdAt][lt]

string

Reservation created strictly before timestamp (ISO 8601)

filter[createdAt][gte]

string

Reservation created on/after timestamp (ISO 8601)

filter[checkOut][lte]

string

Check-out on/before date

filter[checkOut][gte]

string

Check-out on/after date

filter[checkIn][lt]

string

Check-in strictly before date

filter[checkIn][gte]

string

Check-in on/after date (localized, e.g. 2026-01-01)

Responses

400

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

500

Indicates server-side error while processing the request

200Success