BackAPI reference
- Overview
- Authentication
- Errors and limits
- Code examples
- Moving from Classic
- KPIs
- KPI Categories
- KPI Categories / KPIs
- Breakdown Items
- KPI Entries
- KPI Frequencies
- KPI Icons
- KPI Units
- Reports
- Users
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
- List KPI icons —
GET /v1/kpiicons - Get a KPI icon —
GET /v1/kpiicons/{id}
KPI icon object
| Name | Type | Read Only | Mandatory | Max Len. | Notes |
|---|---|---|---|---|---|
id | integer (16 bit) | yes | no | The value to send as icon_id on a KPI. | |
name | string | yes | no | 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
| Code | Meaning |
|---|---|
200 | OK |
401 | Unauthorized |
403 | Forbidden |
429 | Too Many Requests |
Get a KPI icon
GET /v1/kpiicons/{id}
Requires kpis:read on the API key.
Parameters
| Name | Type | Required | Default | Notes |
|---|---|---|---|---|
id | integer | yes | The icon to return. |
Using curl
curl https://api.simplekpi.com/v1/kpiicons/{id} \
-H "Authorization: Bearer skpi_your_api_key"Status codes
| Code | Meaning |
|---|---|
200 | OK |
401 | Unauthorized |
403 | Forbidden |
404 | Not Found |
429 | Too Many Requests |