Phase #4 – Unified API Endpoints

Table of Contents

Who's this integration guide for.

This integration guide is designed for the developers of booking, brokerage, aggregator and discovery platforms that would like to get live availability, confirm bookings and sync data back to integrated management systems.

Developers of property management systems should contact us for integration information.

The integration is broken down into steps and is designed to help drastically reduce integration time and development resources.

Before getting started.

If not completed yet, refer to docs on syncing data to get started and confirm your platform meets the base setup requirements with these use-cases:

  1. An existing user is able to securely connect to your platform from Syncaroo.
  2. An existing user is then able to map & connect their locations as needed from their management software to your platform.
  3. Your platform is able to receive webhook updates from Syncaroo.
  4. Your platform is authenticated and able to fetch live data updates via the Syncaroo API.

Current API endpoints

Locations

GET /v1/locations
or 
GET /v1/locations/{ID}

Some sample data points:

				
					"Name"              // String. Location Name
"Description"       // String. Location Description
"TimeZone"          // String. Location Timezone
"syncOpenStatus"    // String. Location's current lockdown status.
"address"           // Array.  Location's street address.
"hoursOfOperation"  // Array.  Operating day and hours.

				
			

Resources

GET /v1/locations/{ID}/resources
or 
GET /v1/locations/{ID}/resources/{ID}

Some sample data points:

				
					"description"       // String. Resource description.
"type"              // String. 'hot-desk', 'office', 'meeting-room', 'dedicated-desk', 'floor'
"units"             //
"capacity"          //
"Usage details"     // 
"size"              // Integer. Size in sq ft.
"bookable"          // Boolean. If is currently available for booking.
"availableFrom"     // DateTime. When is next bookable.

				
			

Rates/Prices

/v1/locations/{ID}/resources/{ID}/rates 
or 
/v1/locations/{ID}/resources/{ID}/rates/{ID}

Available Extras

GET /v1/locations/{ID}/resources/{ID}/rates/{ID}/extras
or
GET /v1/locations/{ID}/resources/{ID}/rates/{ID}/extras/{ID}

Extras or addons for a specific rate for a resource (This often includes mailbox costs, lockers, or other services that are available for sale)

Files

GET /v1/locations/{ID}/resources/{ID}/files 
or 
GET /v1/locations/{ID}/resources/{ID}/files/{ID}

Primarily images for now, but will also include other types of files attached to resources.

Live Availability

GET v1/locations/{ID}/resources/{ID}/availability

Returns booked / times unavailable for bookings. This data can be used for internal search / caching purposes.

Booking Confirmations

POST /v1/webhooks

Returns booked / times unavailable for bookings. This data can be used for internal search / caching purposes.