---
title: "Reading KPI data"
url: "https://docs.robotiq.ai/en/article/reading-kpi-data"
language: "en"
last_updated: "2026-05-26T13:51:54.881Z"
---

# Reading KPI data

You can get Key Performance Indicator (KPI) data for each process run using the Robotiq.ai API. This lets you build your own reports and dashboards with other tools like Excel, PowerBI, Tableau, or QlikView.

  Your browser does not support the video tag.

## What You'll Need

-   An Organization Admin role in Robotiq.ai.
-   An application set up in HQ to get a Client Secret.

## How to Get KPI Data

To get KPI data, you first need to create an application in HQ. This application gives you a Client Secret, which you need for API access.

### Step 1: Create a New Application

1.  Go to the **Settings** tab in HQ.
2.  Click on the **Application** tab.
3.  Click the **New application** button.
4.  Fill in the information in the new window.
5.  Choose the scope **kpi\_read**.
6.  Give your application a name, like "KPI Custom Application".
7.  Click **Save**.

Your new application will show up in the list of registered applications.

**Important:** Keep your Client Secret private. Handle it carefully to stop others from getting in without permission.

![](https://cdn-assets.productfruits.com/e835d404-6459-4190-9079-d7584a0bfed7)

![](https://cdn-assets.productfruits.com/c1dcb704-17ce-47e7-9694-756beb45eaa9)

![](https://cdn-assets.productfruits.com/be612a9c-945f-486e-a94c-9195c1055609)

### Step 2: Get an Access Token

1.  Find your new application in the list.
2.  Click the **GET ACCESS TOKEN** button next to your application.
3.  Copy the access token that appears.

You'll use this token to prove who you are when you make API calls.

![](https://cdn-assets.productfruits.com/d6400504-9985-492f-8967-35fd8b66dc2d)

![](https://cdn-assets.productfruits.com/adf07282-2d05-4516-9f8d-cf94343be395)

## Using the API to Get KPI Data

Once you have an access token, you can make API calls to pull KPI data. You can use any API client, like Postman.

### Example API Calls

**First API call for token:** Use your Client Secret and other login details to get an access token.

**Second API call for KPI data:** Use the access token to ask the KPI data API endpoint for information. Copy the data from the response into your application.

![](https://cdn-assets.productfruits.com/a3b1b14c-c320-40be-a498-9e54c28f3472)

![](https://cdn-assets.productfruits.com/5e13d0ea-58fe-4060-8911-5b0a2d24ba22)

![](https://cdn-assets.productfruits.com/f0bf434e-9335-471b-a9da-e853db2e01bc)

For more information on how to retrieve KPI data, please refer to [Filtering and Retrieving KPI Data](https://docs.robotiq.ai/en/article/filtering-and-retrieving-kpi-data)

##   
Related Articles

-   [Add new application](https://docs.robotiq.ai/en/article/add-new-application)
-   [Get Access token](https://docs.robotiq.ai/en/article/get-access-token)
-   [Role Based Access Control](https://docs.robotiq.ai/en/article/role-based-access-control)
-   [Filtering and Retrieving KPI Data](https://docs.robotiq.ai/en/article/filtering-and-retrieving-kpi-data)

## Need Help?

Can't find what you're looking for? Join the [Robotiq Community](https://community.robotiq.ai/home/) to get help from other users and the Robotiq team.