Choose the Analytics API or the generic API
Use Robin's Analytics API to report on and monitor office utilization with historical data. To integrate with other office apps or to get current inventory data, use the generic Robin API.
With the Analytics API, developers get historical workplace data, such as desk, space, people, presence, and related exports. They can then build custom reports in tools such as PowerBI, Looker or Tableau.
Bring Robin data into your analytics tool
Follow these steps to use Robin data in your business intelligence (BI) tool:
- Use the Analytics API to generate and download CSV data.
- Import the CSV into your data warehouse or BI tool. Examples:
- Connect your data warehouse to your BI tool.
- Explore the data in your BI tool.
Analytics API reference
Send a POST request to ask Robin to prepare the data. The response gives you an export ID. Then poll the GET endpoint with the export_id every 10 seconds until the data is ready (a 2xx response). Until the data is ready, GET returns 404.
Authentication
For authentication details and how to generate a token, see the Robin API docs.
Error handling
The API returns these error codes:
- 400: A problem with an input parameter.
- 404: The export is not ready.
- 429: You went over the rate limit (a maximum of 30 POST requests per minute).
Create export
POST https://api.robinpowered.com/v1.0/insights/exports/organizations/[:id]/[:export_type]
This request asks for an Analytics export for an organization and time range. Replace [:export_type] with one of the export types below. For more details, see Exporting workplace data.
Export types
export_type |
Export | Description |
|---|---|---|
activity-summary |
Activity Summary | People-first summary of office activity. |
custom-resources |
Custom Resource | Custom resource reservations and check-ins. |
desks |
Desk | Desk assignments, reservations, check-ins, and cancellations. |
presence |
Workplace Presence | Who indicated they were coming in, with or without a desk, plus detected presence. |
hybrid-work-policy |
Hybrid Work Policy | Hybrid work policy compliance data. |
people-roster |
People Roster | Who is using Robin and user attributes (default building, groups, roles, departments, and more). |
spaces |
Space | Scheduled events in Robin spaces, including event metadata. |
Parameters
| Property | Type | Description |
|---|---|---|
from |
ISO 8601 timestamp | Start date (for example, 2025-12-05T00:00:00Z) |
to |
ISO 8601 timestamp | End date (for example, 2025-12-06T00:00:00Z) |
location_ids (optional) |
Array of integers | List of location IDs (all locations if you leave it out). To find the IDs, use the get organization locations API call. |
Headers
Content-Type: application/json
Example body
{
"from": "2025-12-05T00:00:00Z",
"to": "2025-12-06T00:00:00Z"
}Example requests
Desk export:
POST https://api.robinpowered.com/v1.0/insights/exports/organizations/123/desks
Space export:POST https://api.robinpowered.com/v1.0/insights/exports/organizations/123/spaces
Example response
{
"meta": {
"status_code": 202,
"status": "ACCEPTED",
"message": "",
"errors": []
},
"data": {
"export_id": "6239b88d-9cf6-47a9-9dd3-95f3b0fbdba2",
"report_id": "6239b88d-9cf6-47a9-9dd3-95f3b0fbdba2"
}
}Download export
GET https://api.robinpowered.com/v1.0/insights/exports/[:id]
Use the export_id from the POST response. Poll every 10 seconds or more until the data is ready (no 4xx errors).