# Holistics API

> With Holistics API, you can integrate Holistics into your workflow, enabling data retrieval, schedule management, job triggering, and user provisioning

<Hero
  title="Holistics API"
  subtitle="Integrate Holistics into your own workflow: retrieve data, manage schedules, trigger jobs, and provision users." />

## Introduction

<!-- preview-links test: harmless no-op edit -->

At Holistics, we treat API interface as a first-class citizen. Our goal is to allow you to flexibly integrate Holistics with your workflow as much as possible.

We do this by trying to design an extensive, easy to use API coupled with readily available libraries.

:::tip OpenAPI Specification
Download the [OpenAPI spec (YAML)](/api/v2.yml) to use with API clients, code generators, or AI agents.
:::

:::caution
**Holistics API version does not correlate with Holistics feature version**. For example, Holistics API v2 can support operations on Holistics 2.0, 2.7 and 3.0.

The latest API version is API v2.

API v1 and below is considered legacy API. Legacy API is functional but is not in active development/ maintenance anymore.
:::

## Use cases

These are some of the most common things teams reach for the API to do.

<CardGrid cols={2}>
  <Card title="Get report data" href="/api/v2/get-data" cta="Export widget data">
    Programmatically export CSV or Excel data from any dashboard or chart, so you can pass live numbers to your other applications.
  </Card>
  <Card title="Trigger schedules" href="/api/v2/reference/data-schedules-submit-execute" cta="Execute a schedule">
    Kick off data schedule jobs from your own workflow, on your own triggers, instead of waiting for the next scheduled run.
  </Card>
  <Card title="Manage dashboards" href="/api/v2/reference/dashboards-list" cta="Browse dashboard endpoints">
    List, fetch, clone, and manage dashboards. Set up email report delivery to your customers when a new account onboards.
  </Card>
  <Card title="User management" href="/api/v2/reference/users-list" badge="Upcoming" cta="Browse user endpoints">
    Provision and deprovision users programmatically to keep access in sync with your own systems.
  </Card>
</CardGrid>

:::info
Our API is currently work-in-progress, so some of the use cases/features might not be available. If you have an API use case you want to support/prioritize, please reach out to our Support.
:::

## Data Center Regions

API data is limited to specific regions. You must use the correct subdomain for your data center region.

| Region | API Base URL |
|--------|--------------|
| Asia-Pacific (APAC) | `https://secure.holistics.io/api/v2` |
| Europe (EU) | `https://eu.holistics.io/api/v2` |
| United States (US) | `https://us.holistics.io/api/v2` |

:::tip Finding your region
Check the URL when you log into Holistics:
- `secure.holistics.io` → APAC
- `eu.holistics.io` → EU
- `us.holistics.io` → US

See [Data Centers](/docs/security-compliance/data-centers#how-do-i-know-which-data-center-im-on) for more details.
:::

## Authentication

All API requests require authentication using an API key passed in the `X-Holistics-Key` header.

```bash
curl -X GET \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -H "X-Holistics-Key: YOUR_API_KEY" \
  https://secure.holistics.io/api/v2/users/me
```

For step-by-step instructions on enabling API access, generating your API key, and making your first call, see the [Getting Started guide](/api/v2/getting-started).