Requesting data on an ongoing basis:

• Make single-day export creation requests (POST) each day to capture the previous day’s data.

• GET requests to retrieve the generated export after the creation request should poll at 10-second or greater intervals. See the GET endpoint below for more information.

Error handling:

• 400 - if there are problems relating to the input parameters

• 429 - if the request rate exceeds the prescribed limit.

  • 30 POSTs per minute

We reserve the right to make additive changes to the data returned. Existing columns will not be removed, but new ones may be added. Your code should be flexible enough to not fail if additional data is returned.

Authentication

Please see our API documentation over at https://docs.robinpowered.com/docs to get an understanding of how our REST API works with Authentication etc., and generate a token for your organization.

Usage

Below, you will find POST and GET methods. You will end up calling both. The POST tells Robin that you would like data prepared for download. This is an asynchronous request and returns an export ID.

Next, call the single shared GET endpoint with the export ID from the POST request. You'll receive 404 responses until the data is ready. Once the data is ready, you'll receive a 20x status and the CSV data in the response. These GET calls should be made at 10-second intervals. 

Export API

Requests

Each export has a slightly different endpoint as described below. Exports are returned as CSV files. Columns are generally not removed from the exports but may be added or moved.

Request organization events export:

POST https://api.robinpowered.com/v1.0/insights/exports/organizations/[:id]/spaces

This retrieves all events scheduled in Robin spaces within the specified time range. 

Parameters:

Headers:

Content-type: application/json

Example Body:

{
"from": "2022-12-05T00:00:00-04:00",
"to": "2022-12-06T00:00:00-04:00"
}

 Example Response:

{
"meta": {
"status_code": 202,
"status": "ACCEPTED",
"message": "",
"more_info": {},
"errors": []
},
"data": {
"export_id": "6239b88d-9cf6-47a9-9dd3-95f3b0fbdba2",
"report_id": "6239b88d-9cf6-47a9-9dd3-95f3b0fbdba2"
}
}

Request organization desks export:

POST https://api.robinpowered.com/v1.0/insights/exports/organizations/[:id]/desks

This requests all desk assignments and reservations within the specified time range.

Parameters:

Headers:

Content-type: application/json

Example Body:

{
"from": "2022-12-05T00:00:00-04:00",
"to": "2022-12-06T00:00:00-04:00"
}

Example Response:

{
"meta": {
"status_code": 202,
"status": "ACCEPTED",
"message": "",
"more_info": {},
"errors": []
},
"data": {
"export_id": "6239b88d-9cf6-47a9-9dd3-95f3b0fbdba2",
"report_id": "6239b88d-9cf6-47a9-9dd3-95f3b0fbdba2"
}
}

Request and download an export:

GET https://api.robinpowered.com/v1.0/insights/exports/[:id]

** Polling should be done at 10 second or greater intervals.**

Event Export Fields:

Organization
Building
Floor
Space
Space ID
Event ID
Event Status
Created At (UTC)
Updated At (UTC)
All Day Event
Title
Is Recurring
Capacity
Invited People
Attendees
Location
Started At (UTC)
Ended At (UTC)
Minute Duration
Checked In At (UTC)
Minutes Delayed
Automatically Unbooked At (UTC)
Creator Robin ID
Creator Robin Name
Creator Department
Creator Groups
Creator Robin Email
Created By Email
Host Robin ID
Host Robin Name
Host Department
Host Groups
Host Robin Email
Hosting Calendar Email
Local Creator ID
Local Creator Email
Cancellation Type

Desk Export Fields:

Organization
Building
Floor
Desk Group
Desk ID
Desk Name
Reservation ID
Series ID
Type
Start (UTC)
End (UTC)
Hour Duration
Checked In At (UTC)
Canceled At (UTC)
Cancellation Type
Creator Name
Creator Department
Creator Groups
Creator Email
Assignee Name
Assignee Department
Assignee Groups
Assignee Email
Desk Type
Bookable On Unassigned Days