---
title: "Get KPIs."
method: GET
path: "/kpi"
---

# Get KPIs.

`GET /kpi`

This endpoint employs cursor pagination for improved response handling for both the server and the client. The cursor token needed for subsequent requests is included in the response until all data is exhausted.

## Query parameters

- `limit` integer
- `cursor` string
- `order` string

## Response `200`

Paginated KPI list

- object
  - `pagination` Pagination
    - `limit` integer
    - `order` string
    - `results_count` integer
    - `cursor` string
    - `next_cursor` string
  - `results` Kpi[]
    - `id` string
    - `currentValue` number
    - `name` string
    - `description` string
    - `type` string
    - `parent` object
      - `slug` string
      - `name` string
    - `created` string, date-time
    - `edited` string, date-time
    - `createdBy` string
    - `editedBy` string
    - `lastUpdated` object
      - `value` number
      - `timestamp` string, date-time
    - `updateFrequency` 'daily' | 'weekly' | 'monthly' | 'quarterly' | 'annual' | 'irregular'
    - `isStale` boolean

## Other responses

- `400` — A bad request
- `500` — Something went wrong

## Changes

- **2023-12-06** `3f64265723e5` — 4 info
  - added the new optional `query` request parameter `cursor`
  - added the new optional `query` request parameter `limit`
  - added the new optional `query` request parameter `order`
  - added the non-success response with the status `400`
- **2023-03-06** `d651c18ad7d7` — 3 warning, 1 info
  - deleted the `query` request parameter `cursor`
  - deleted the `query` request parameter `limit`
  - deleted the `query` request parameter `order`
  - removed the non-success response with the status `400`

[Change history](https://skmtc.dev/oslokommune/apis/okr-tracker-api/changes/kpi/get.md)

---

[API](https://skmtc.dev/oslokommune/apis/okr-tracker-api.md) · [All operations](https://skmtc.dev/oslokommune/apis/okr-tracker-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/oslokommune/okr-tracker-api/revisions/7c311e87bded/schema)
