Rental Links

Overview

This resource represents Rental Links which are managed via Rental Link Groups.

The purpose of the Rental Links is to mirror the availabilities between two Rentals - if there is a link between Rental A and Rental B, creating (or canceling) a Booking for either of them will result in creating/canceling a "mirrored" Booking on the other Rental.

Parameters

OAuth Scopes:

public

Name	Type	Read/Write	Description
account	Integer	Read	Account's ID related to the Rental link
rental_link_group	Integer	Read	Rental link Group's ID related to the Rental link
source_rental	Integer	Read	Rental's ID (as source of the link) related to the Rental link
destination_rental	Integer	Read	Rental's ID (as destination of the link) related to the Rental link
id	Integer	Read	Rental link's ID.
kind	String	Read	Rental link's kind, list of rental link's rate kinds described in enums section.
created_at	Time	Read	Rental link's create time.
updated_at	Time	Read	Rental link's update time.

List rental links

List all rental link for a given account(s).

GET /rental_links

OAuth Scopes:

public

response.json

{
  "links": {
    "rental_links.account": "https://www.bookingsync.com/api/v3/accounts/{rental_links.account}",
    "rental_links.destination_rental": "https://www.bookingsync.com/api/v3/rentals/{rental_links.destination_rental}",
    "rental_links.rental_link_group": "https://www.bookingsync.com/api/v3/rental_link_groups/{rental_links.rental_link_group}",
    "rental_links.source_rental": "https://www.bookingsync.com/api/v3/rentals/{rental_links.source_rental}"
  },
  "rental_links": [
    {
      "links": {
        "account": 1,
        "destination_rental": 2,
        "rental_link_group": 1,
        "source_rental": 3
      },
      "id": 1,
      "kind": "mirror",
      "created_at": "2025-03-31T17:52:12.095Z",
      "updated_at": "2025-04-07T17:52:12.095Z"
    }
  ],
  "meta": {}
}

Get a single rental link

Returns a single rental link identified by ID.

GET /rental_links/:rental_link_id

OAuth Scopes:

public

response.json

{
  "links": {
    "rental_links.account": "https://www.bookingsync.com/api/v3/accounts/{rental_links.account}",
    "rental_links.destination_rental": "https://www.bookingsync.com/api/v3/rentals/{rental_links.destination_rental}",
    "rental_links.rental_link_group": "https://www.bookingsync.com/api/v3/rental_link_groups/{rental_links.rental_link_group}",
    "rental_links.source_rental": "https://www.bookingsync.com/api/v3/rentals/{rental_links.source_rental}"
  },
  "rental_links": [
    {
      "links": {
        "account": 1,
        "destination_rental": 2,
        "rental_link_group": 1,
        "source_rental": 3
      },
      "id": 1,
      "kind": "mirror",
      "created_at": "2025-03-31T17:52:12.096Z",
      "updated_at": "2025-04-07T17:52:12.096Z"
    }
  ],
  "meta": {}
}