Robin's Analytics API

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:

  1. Use the Analytics API to generate and download CSV data.
  2. Import the CSV into your data warehouse or BI tool. Examples:
  3. Connect your data warehouse to your BI tool.
  4. 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).

Articles in this section

Was this article helpful?
3 out of 6 found this helpful
Share