Skip to content

Strategic Themes & OKRs API

Retrieve the full portfolio OKR hierarchy from Kendis: Portfolio Themes → Strategic Themes → Objective Groups → Objectives → Key Results, with completion roll-ups, progress, metrics, and type-aware custom fields.

  • Method: Versioned subdomain — https://{yourcompany}.kendis.io/api/v1/… (details)
  • Auth: HTTP Basic — email : API key
  • Envelope: { "startAt", "pageLimit", "total", "Data": [ … ] } — note the capital Data
  • Pagination: startAt / pageLimit query params (max 50)
  • Lookup: {keyOrId} accepts either the item's key or its internal ID

Envelope key is Data (capital D)

This API returns its result array under Data, unlike the other Kendis APIs which use lowercase data. Read the key exactly as documented. See Conventions.

The hierarchy

graph TD
  PT[Portfolio Theme] --> ST[Strategic Theme]
  ST --> OG[Objective Group · level 1]
  OG --> O[Objective · level 2]
  O --> KR[Key Result · level 3]

Each entity carries a numeric level (1 group, 2 objective, 3 key result) and a type string ("Objective Group", "Objective", "Key Result") so a flat-table consumer such as PowerBI can group rows without tracking which endpoint produced them.

Quick reference

Action Method Path
List Portfolio Themes GET /api/v1/portfolio-themes
Get Portfolio Theme GET /api/v1/portfolio-themes/{keyOrId}
Strategic Themes in Portfolio Theme GET /api/v1/portfolio-themes/{keyOrId}/strategic-themes
List Strategic Themes GET /api/v1/strategic-themes
Get Strategic Theme GET /api/v1/strategic-themes/{keyOrId}
Objective Groups in Strategic Theme GET /api/v1/strategic-themes/{keyOrId}/objective-groups
Strategic Theme progress GET /api/v1/strategic-themes/{keyOrId}/progress
Objectives in Objective Group GET /api/v1/objective-groups/{groupId}/objectives
Get Objective GET /api/v1/objectives/{keyOrId}
Key Results for Objective GET /api/v1/objectives/{keyOrId}/key-results
Get Key Result GET /api/v1/key-results/{keyOrId}

All URLs: https://{yourcompany}.kendis.io + the path above. All {keyOrId} parameters accept either the item's key (e.g. CV-20, OBJ-329, KR-141) or its internal ID.