KPIs

KPIs and their values over time.

GET/v1/kpis

List KPIs

Active KPIs on the scorecard that you can see, with their goal, owner and team.

Needs kpis:readMCP tool list_kpis

Query parameters

  • team_idstring or null

    A 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}/values

Get a KPI's values

A KPI's recorded values by period, oldest first.

Needs kpis:readMCP tool get_kpi_values

Path parameters

  • kpi_idstringRequired

Query parameters

  • sincestring (date) or null

    Periods starting on or after this day

  • untilstring (date) or null

    Periods starting on or before this day

Response

  • kpi_idstringRequired
  • datalist 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"
    }
  ]
}