<Info>This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.</Info>

Returns what each KPI in the Marketing Agent's plan measures right now, read from the app's analytics.

values is in the same order as kpis in Get Marketing Agent state, so match the two by position rather than by name. A plan with no KPIs yet returns an empty list. Read state before value: a KPI that can't be measured has no value rather than a 0.

Values can be up to an hour old. They're read again when the KPIs change, and on every call while any KPI is not_tracked or unavailable, so a newly recorded event shows up on the next call.

This is limited to 120 requests a minute per app for each workspace's personal API keys, so every key in a workspace shares one allowance, across every Marketing Agent endpoint. Some workspaces have a different limit.

<Note>This endpoint accepts a personal API key belonging to a user with editor access to the app and an editor role in its workspace. Read-only keys and workspace API keys are refused.</Note>

{
  "values": [
    {
      "first_seen": "2026-08-22T10:00:00Z",
      "state": "measured",
      "value": 42,
      "window_days": 7
    }
  ]
}