SimpleKPI Logo

SimpleKPI AI › API reference

KPI Icons

A read-only lookup of the icons a KPI can be given. The ids returned here are what icon_id on a KPI accepts.

Icons are shared across all accounts, so this list is the same for everyone.

Base URL https://api.simplekpi.com/v1

Endpoints

  1. List KPI iconsGET /v1/kpiicons
  2. Get a KPI iconGET /v1/kpiicons/{id}

KPI icon object

NameTypeRead OnlyMandatoryMax Len.Notes
idinteger (16 bit)yesno The value to send as icon_id on a KPI.
namestringyesno The icon's display name.

List KPI icons

GET /v1/kpiicons

Requires kpis:read on the API key.

Using curl

curl https://api.simplekpi.com/v1/kpiicons \
  -H "Authorization: Bearer skpi_your_api_key"

Example response

Status: 200 OK
[
  {
    "id": 1,
    "name": "Bar chart"
  }
]

Status codes

CodeMeaning
200OK
401Unauthorized
403Forbidden
429Too Many Requests

 

Get a KPI icon

GET /v1/kpiicons/{id}

Requires kpis:read on the API key.

Parameters

NameTypeRequiredDefaultNotes
idintegeryes The icon to return.

Using curl

curl https://api.simplekpi.com/v1/kpiicons/{id} \
  -H "Authorization: Bearer skpi_your_api_key"

Status codes

CodeMeaning
200OK
401Unauthorized
403Forbidden
404Not Found
429Too Many Requests