List listings

get

https://open-api.guesty.com/v1/listings

Retrieve the listings on your account as a paginated result set carrying results, fields and limit. Combine the filter parameters to narrow the set, or pass viewId to apply the filters, fields and sort order saved in a view.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

ids

string

Limit results to these ids, comma separated

nids

string

Limit results to not include these ids, comma separated

viewId

string

Retrieve a specific saved listings view (a view is a saved custom report)

string

Search query string. Searches in title, internalNote, address.full

city

string

Limit results to city

active

boolean

Defaults to true

Limit results to active state. Boolean, true for only active, false for only inactive, don't include for all.

pmsActive

boolean

Defaults to true

Limit results to listings with the feature pms active. Boolean, true for only active, false for only inactive, don't include for all.

integrationId

string

Limit results to specific integration

listed

boolean

Defaults to true

Limit results to listed state. Boolean, true for only listed, false for only unlisted, don't include for all.

available

object

Limit results to only available listings in specific dates

IMPORTANT NOTE:
Fields in this query must be enclosed in curly braces as shown below, and NOT as displayed in the coding playground output.
available = {"checkIn":"YYYY-MM-DD","checkOut":"YYYY-MM-DD","minOccupancy":3}

ignoreFlexibleBlocks

boolean

Defaults to false

Shows available listings and listings with flexible blocks.

200Listings Array