Bookings Taxes

  1. List bookings taxes
  2. Get a single bookings tax

Parameters

Name Type Read/Write Description
id Integer Read Bookings Tax’s id.
amount Decimal Read Bookings Tax’s amount.
name Object Read Bookings Tax’s name, list of locales described in enums section.
percentage Decimal Read Bookings Tax’s percentage.
tax_included_in_price Boolean Read Tax amount already included in taxable(Rental or Bookings Fee) final price if set to true.

List bookings taxes

Based on the OAuth token scopes bookings taxes will be limited to a certain range.

Scope Read Permissions
:bookings_write_owned Display only bookings taxes for bookings created by app making the request
:bookings_read Display all bookings taxes
:bookings_write Display all bookings taxes

List all bookings taxes for current account(s).

GET /bookings_taxes

Response

{
  "links": {
    "bookings_taxes.booking": "http://www.bookingsync.com/api/v3/bookings/{bookings_taxes.booking}",
    "bookings_taxes.fee": "http://www.bookingsync.com/api/v3/fees/{bookings_taxes.taxable.id}",
    "bookings_taxes.rental": "http://www.bookingsync.com/api/v3/rentals/{bookings_taxes.taxable.id}",
    "bookings_taxes.tax": "http://www.bookingsync.com/api/v3/taxes/{bookings_taxes.tax}"
  },
  "bookings_taxes": [
    {
      "id": 52,
      "amount": "1565.2",
      "name": {
        "en": "Bookings Tax"
      },
      "percentage": "455.0",
      "tax_included_in_price": false,
      "links": {
        "account": 3,
        "booking": 1382,
        "tax": 7,
        "taxable": {
          "id": 1,
          "type": "Rental"
        }
      }
    }
  ],
  "meta": {
  }
}

Get a single bookings tax

Returns a single bookings tax identified by ID.

GET /bookings_taxes/:bookings_tax_id

Response

{
  "links": {
    "bookings_taxes.booking": "http://www.bookingsync.com/api/v3/bookings/{bookings_taxes.booking}",
    "bookings_taxes.fee": "http://www.bookingsync.com/api/v3/fees/{bookings_taxes.taxable.id}",
    "bookings_taxes.rental": "http://www.bookingsync.com/api/v3/rentals/{bookings_taxes.taxable.id}",
    "bookings_taxes.tax": "http://www.bookingsync.com/api/v3/taxes/{bookings_taxes.tax}"
  },
  "bookings_taxes": [
    {
      "id": 52,
      "amount": "1565.2",
      "name": {
        "en": "Bookings Tax"
      },
      "percentage": "455.0",
      "tax_included_in_price": false,
      "links": {
        "account": 3,
        "booking": 1382,
        "tax": 7,
        "taxable": {
          "id": 1,
          "type": "Rental"
        }
      }
    }
  ],
  "meta": {
  }
}