Skip to main content
Version: 1.0.0

ArborXR Insights API

Welcome to the ArborXR Insights API! This API is specifically designed for Business Intelligence (BI) tools like Power BI, Tableau, and other data visualization platforms.

Getting Started​

  1. Get Access Token: Create access token in ArborXR Portal. Select the "insights-api" ability.
  2. Authentication: Use Authorization: Bearer <token> header
  3. Fetch Data: Use the /v1/insights/bi/data endpoint to retrieve your Insights data
    • Base URL: https://insights-api.xrdm.app — prepend this to all endpoint paths when making requests.

Authentication​

All endpoints require access token authentication using the Bearer token format:

Authorization: Bearer 1|62uEa...8390b

Access tokens are organization-scoped and provide access only to your organization's data.

Supported BI Tools​

  • Power BI: Use Web connector with custom headers
  • Tableau: Web Data Connector with Bearer authentication
  • Excel: Power Query with Web source
  • Custom Applications: Any HTTP client supporting Bearer tokens

PowerBI Integration

Setup Steps​

  1. In Power BI, select "Get Data" → "Web".

  2. Enter the full endpoint URL with your query parameters.

  3. Add the HTTP header Authorization: Bearer <token>.

  4. Configure incremental refresh using start_date/end_date parameters as needed.

    Examples​

    • Minimal example: 
      https://insights-api.xrdm.app/v1/insights/bi/data?application_ids=&lt;YOUR_APP_ID&gt;
    • With page size (use & to add additional parameters after the first ?): 
      https://insights-api.xrdm.app/v1/insights/bi/data?application_ids=&lt;YOUR_APP_ID&gt;&page_size=2000
    • Multiple applications and collection override: 
      https://insights-api.xrdm.app/v1/insights/bi/data?application_ids=&lt;APP_ID_1&gt;&application_ids=&lt;APP_ID_2&gt;&collection=telemetry&page=1&page_size=5000

Support​

For API support, please contact your ArborXR administrator or visit support.arborxr.com.