API Reference
Log In
API Reference

Get Reservations

get
https://app.hosttools.com/api/getReservations///

Gets reservations of a listing within a date range.

Two matching rules apply. Reservations that have stay dates are returned when their stay overlaps the requested range. Dateless inquiries — where the guest opened an inquiry without selecting dates, so the reservation has no startDate or endDate — are returned when their inquiryDate falls inside the requested range instead. Responses can therefore include reservations whose startDate and endDate fields are absent.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

_id of listing to fetch

string
required

Start date of range of reservations to fetch. Defaults to today if not provided.

string
required

End date of range of reservations to fetch. Defaults to two years from startDate if not provided.

Headers
string

Partner API key (deprecated — use OAuth 2.0 for new integrations)

string

User's authentication token (legacy). Use Authorization Bearer header for new integrations.

Responses

429

Too many requests

Updated 5 months ago

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 5 months ago