KPIs
KPIs and their values over time.
GET
/v1/kpisList KPIs
Active KPIs on the scorecard that you can see, with their goal, owner and team.
Needs
kpis:readMCP tool list_kpisQuery parameters
team_idstring or nullA team's KPIs plus the org-wide ones
Response
datalist of KpiRequired
curl "https://developers.playbookops.ai/v1/kpis" \
-H "Authorization: Bearer $PLAYBOOKOPS_API_KEY"Response · 200
{
"data": [
{
"id": "6f1d2c1e-8a3b-4b8e-9d55-2c0f9e7a1b42",
"name": "Ana Ruiz",
"description": "Confirm the date and ask about parking.",
"unit": "percent",
"frequency": "monthly",
"goal": 0,
"goal_direction": "above",
"owner_name": "Ana Ruiz",
"team_name": "Operations"
}
]
}GET
/v1/kpis/{kpi_id}/valuesGet a KPI's values
A KPI's recorded values by period, oldest first.
Needs
kpis:readMCP tool get_kpi_valuesPath parameters
kpi_idstringRequired
Query parameters
sincestring (date) or nullPeriods starting on or after this day
untilstring (date) or nullPeriods starting on or before this day
Response
kpi_idstringRequireddatalist of KpiValueRequired
curl "https://developers.playbookops.ai/v1/kpis/KPI_ID/values" \
-H "Authorization: Bearer $PLAYBOOKOPS_API_KEY"Response · 200
{
"kpi_id": "6f1d2c1e-8a3b-4b8e-9d55-2c0f9e7a1b42",
"data": [
{
"period_start": "2026-11-21",
"value": 0,
"note": "Up after the spring campaign"
}
]
}