Returns the authenticated user's listings, including disabled ones (listingEnabled: false). Each listing includes
property details, location information, current settings, and (when connected)
per-channel external IDs under channels (e.g. Airbnb listing id, Booking.com property id).
For direct booking, channels.direct lists only enabled sites with public URLs.
If both startDate and endDate query parameters are provided, the endpoint will
filter listings to only return those that are available for the specified date range.
This includes checking for blocked dates, minimum night requirements, and pricing availability.
Listings are returned newest first (most recently imported first). By default every listing comes back in one response. To page through a large account, pass limit, then pass the returned nextCursor as cursor to get the next page. Keep going until nextCursor is null. With startDate and endDate, a page can hold fewer than limit listings even when more remain, so don't stop at a short page — only stop when nextCursor is null.
To keep a copy of a large account up to date, don't fetch every listing on each poll. Fetch everything once, then pass updatedSince to get only the listings that changed, or use the listing webhooks.
Authentication: Pass either Authorization: Bearer <token> (OAuth 2.0) or the legacy authToken header.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
429Too many requests