Rates Tables

Overview

This resource represents Rates Tables - a resource for grouping price-related resources (such as Rates Rules, Seasons, Periods) for Rentals. Rates Tables can be shared between Rentals to make pricing setup between rentals reusable.

Rates Tables cannot be updated or swapped to a different one if they have:

private status (shared as false)
corresponding rental has external rates management configured (nightly_rates_managed_externally as true)

Parameters

OAuth Scopes:
rates_read
rates_write

Name	Type	Read/Write	Description
account	Integer	Read	Account's ID related to the Rates Table
seasons	Array	Read	Seasons' IDs related to the Rates Table
rates_rules	Array	Read	Rates Rules' IDs related to the Rates Table
periods	Array	Read	Periods' IDs related to the Rates Table
rentals	Array	Read	Rentals' IDs related to the Rates Table
id	Integer	Read	Rates Table's ID.
name	Object	Read	Rates Table's name, list of locales described in enums section
shared	Boolean	Read	Rates Table's shared (between Rentals) status.
public_notes	String	Read	Rates Table's public notes.
created_at	Time	Read	Rate's create time.
updated_at	Time	Read	Rate's update time.

Name	Type	Read/Write	Description	Constraints
account	Integer	Read	Account's ID related to the Rates Table
seasons	Array	Read	Seasons' IDs related to the Rates Table
rates_rules	Array	Read	Rates Rules' IDs related to the Rates Table
periods	Array	Read	Periods' IDs related to the Rates Table
rentals	Array	Read	Rentals' IDs related to the Rates Table
id	Integer	Read	Rates Table's ID.
name	Object	Read/Write	Rates Table's name, list of locales described in enums section	Required for Account's default locale, maximum length: 25
shared	Boolean	Read	Rates Table's shared (between Rentals) status. (Rates Table is always marked as shared when creating or updating through API)
public_notes	String	Read	Rates Table's public notes.
created_at	Time	Read	Rate's create time.
updated_at	Time	Read	Rate's update time.

List rates tables

List all rates tables for a given account.

GET /rates_tables

OAuth Scopes:
rates_read / rates_write

response.json
{
  "links": {
    "rates_tables.account": "https://www.bookingsync.com/api/v3/accounts/{rates_tables.account}",
    "rates_tables.seasons": "https://www.bookingsync.com/api/v3/seasons/{rates_tables.seasons}",
    "rates_tables.rates_rules": "https://www.bookingsync.com/api/v3/rates_rules/{rates_tables.rates_rules}",
    "rates_tables.periods": "https://www.bookingsync.com/api/v3/periods/{rates_tables.periods}"
  },
  "rates_tables": [
    {
      "links": {
        "account": 5,
        "seasons": [
          2,
          34
        ],
        "rates_rules": [
          3,
          7
        ],
        "periods": [
          2,
          3
        ]
      },
      "id": 2,
      "name": "Rates Table 2",
      "shared": true,
      "created_at": "2025-04-08T12:05:06.616Z",
      "updated_at": "2025-04-15T12:05:06.616Z"
    }
  ]
}

Get a single rates table

Returns a single rates table identified by ID.

GET /rates_tables/:rates_table_id

OAuth Scopes:
rates_read / rates_write

response.json
{
  "links": {
    "rates_tables.account": "https://www.bookingsync.com/api/v3/accounts/{rates_tables.account}",
    "rates_tables.seasons": "https://www.bookingsync.com/api/v3/seasons/{rates_tables.seasons}",
    "rates_tables.rates_rules": "https://www.bookingsync.com/api/v3/rates_rules/{rates_tables.rates_rules}",
    "rates_tables.periods": "https://www.bookingsync.com/api/v3/periods/{rates_tables.periods}"
  },
  "rates_tables": [
    {
      "links": {
        "account": 5,
        "seasons": [
          2,
          34
        ],
        "rates_rules": [
          3,
          7
        ],
        "periods": [
          2,
          3
        ]
      },
      "id": 2,
      "name": "Rates Table 2",
      "shared": true,
      "created_at": "2025-04-08T12:05:06.618Z",
      "updated_at": "2025-04-15T12:05:06.618Z"
    }
  ]
}

Create a new rates table

Cloning a rates table

To clone an existing rates table, pass "clone_from": "ID" parameter with ID of the source.

Returns a newly created rates table.

POST /rates_tables

OAuth Scopes:
rates_write

request.json
{
  "rates_tables": [
    {
      "name": "Rates Table 2"
    }
  ]
}

response.json
{
  "links": {
    "rates_tables.account": "https://www.bookingsync.com/api/v3/accounts/{rates_tables.account}",
    "rates_tables.seasons": "https://www.bookingsync.com/api/v3/seasons/{rates_tables.seasons}",
    "rates_tables.rates_rules": "https://www.bookingsync.com/api/v3/rates_rules/{rates_tables.rates_rules}",
    "rates_tables.periods": "https://www.bookingsync.com/api/v3/periods/{rates_tables.periods}"
  },
  "rates_tables": [
    {
      "links": {
        "account": 5,
        "seasons": [
          2,
          34
        ],
        "rates_rules": [
          3,
          7
        ],
        "periods": [
          2,
          3
        ]
      },
      "id": 2,
      "name": "Rates Table 2",
      "shared": true,
      "created_at": "2025-04-08T12:05:06.619Z",
      "updated_at": "2025-04-15T12:05:06.619Z"
    }
  ]
}

Update a rates table

Returns an updated rates table identified by ID.

PUT /rates_tables/:rates_table_id

OAuth Scopes:
rates_write

request.json
{
  "rates_tables": [
    {
      "name": "Rates Table 2"
    }
  ]
}

response.json
{
  "links": {
    "rates_tables.account": "https://www.bookingsync.com/api/v3/accounts/{rates_tables.account}",
    "rates_tables.seasons": "https://www.bookingsync.com/api/v3/seasons/{rates_tables.seasons}",
    "rates_tables.rates_rules": "https://www.bookingsync.com/api/v3/rates_rules/{rates_tables.rates_rules}",
    "rates_tables.periods": "https://www.bookingsync.com/api/v3/periods/{rates_tables.periods}"
  },
  "rates_tables": [
    {
      "links": {
        "account": 5,
        "seasons": [
          2,
          34
        ],
        "rates_rules": [
          3,
          7
        ],
        "periods": [
          2,
          3
        ]
      },
      "id": 2,
      "name": "Rates Table 2",
      "shared": true,
      "created_at": "2025-04-08T12:05:06.620Z",
      "updated_at": "2025-04-15T12:05:06.620Z"
    }
  ]
}

Destroy a rates table

Required OAuth scope: :rates_write

Returns an empty response with 204 No Content status code on success.

DELETE /rates_tables/:rates_table_id

Overview​

Parameters​

List rates tables​

Get a single rates table​

Create a new rates table​

Update a rates table​

Destroy a rates table​