get
https://app.hosttools.com/api/getExpenses
Returns the user's expenses and extra income, a page at a time. These are the amounts entered by hand in Owner Statements, per listing, including internal expenses (the manager's own costs, chargeTo: internal); booking income and channel payouts aren't included. Entries on listings turned off or hidden are returned too, as owner statements count them. Requires the ownerStatements:read scope.
Send either a date range or updatedSince:
startDateandendDatereturn the entries dated in the range, oldest date first, withtotal.listingIDs,listingGroupIDs,kindandchargeTonarrow them.updatedSincereturns every entry created, changed or deleted at or after that time, whatever its date, oldest change first. A deleted entry comes back once more, withdeletedAt, so a copy you keep can drop it. Use it to keep a copy in sync instead of reading every range again: save the time just before each call, minus a minute for clock differences, and pass it asupdatedSinceon the next call. It takes no other filter, since an entry moved to another listing, date or kind would otherwise drop out of the filter unseen. An entry changed while you page moves to a later page, so it is read again rather than missed. There's no webhook for expenses yet, so poll withupdatedSinceto pick up changes.
Amounts are numbers in the listing's currency (currency), always above 0: kind says whether an entry is an expense or extra income.
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
403The OAuth token doesn't have the ownerStatements:read scope
429Too many requests