Experience the difference of "Elite".

Please add additional fields to the API

Tim
Feb 11, 2024 12:46 PM
Joined Oct, 2018 45 posts

I'm requesting that you add the following fields to the Bookings API:

  total_rent
  total_surcharges
  total_taxes
  total_channel_fees

Currently, the API only provides these:

  total_amount
  total_host_fees
  total_paid

The problem with what you provide (from an investor/business standpoint) is that total_rent includes things like cleaning & taxes, which makes it useless for looking at profitability. This is made worse by the fact that some channels charge guests for taxes separately (AirBNB) and for some (VRBO) hosts collect and then remit them later, so it's impossible to predict how much of "total_amount" is actually income.

I realize that the API includes an array called "charges" which includes each line item charge, however this is very difficult to enumerate in code and tie to the parent record. It would be much easier to just include it in the base array along with the other totals.

Thank you for your consideration

Ryan C
Feb 21, 2024 6:16 PM
OR Team Member Joined Feb, 2023 6 posts

Hi Tim,

Thank you for the suggestions. I've passed those along to our product management team for consideration. Let us know if you think of any other response fields that you would like to see for any of the API endpoints and we can look into those as well.