---
title: "The cards and narrative numbers of the Live checks tab"
method: GET
path: "/analytics/v1/live/cards"
tags: ["analytics"]
---

# The cards and narrative numbers of the Live checks tab

`GET /analytics/v1/live/cards`

## Request

- Base URL: `https://api.qualityclouds.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.qualityclouds.ai/analytics/v1/live/cards`
- Auth: one of:
  - HTTP bearer
  - OpenID Connect (`https://account.qualityclouds.com//realms/ai-production/.well-known/openid-configuration`)

Checks, files checked, issues found and fixes reported by the agent, plus the workspace figures the narrative needs. Organisation totals for the filters; `members` and `devs_not_connected` ignore the filters.

## Query parameters

- `weeks` integer: Length of the period in ISO weeks. One of [4, 8, 12, 26].
- `repository_id` string, nullable: Narrow to one repository.
- `user_id` string, nullable: Narrow to one developer: the owner of the connection.
- `client` string[], nullable: Repeatable. Canonical client label, e.g. 'Cursor'.

## Response `200`

Successful Response

- LiveCardsResponse: `GET /live/cards` — functional §7.1 and §7.2.
  - `checks` integer, required: `live_check` calls in the period
  - `files_checked` integer, required: Distinct (repository, path) pairs checked in the period; always <= checks
  - `repositories` integer, required: Distinct repositories of the checks
  - `per_week` number, required: Checks divided by the weeks of the period, rounded half-up to one decimal
  - `pending` integer, required: Files checked with no merged-file row of their path after the check
  - `issues_found` integer, required: Issues `live_check` returned in the period
  - `issues_high` integer, required: Of those, issues from rules of severity HIGH
  - `fixes_reported` integer, required: Issues the agent later reported fixed or prevented through `register_applied_actions`, same repository, rule and path. Not verified.
  - `members` integer, required: Users with a role in the organisation
  - `devs_active` integer, required: Distinct connection owners with a check in the period
  - `devs_not_connected` integer, required: Members with no MCP connection and no check ever
  - `clients` integer, required: Distinct clients of the checks
  - `client_name` string, nullable: The client's label when `clients` is 1, otherwise null

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `422`: Validation Error

---

[API](https://skmtc.dev/qualityclouds/apis/qai-orchestrator-api.md) · [All operations](https://skmtc.dev/qualityclouds/apis/qai-orchestrator-api/llms.txt) · [OpenAPI document](https://skmtc.dev/qualityclouds/apis/qai-orchestrator-api/revisions/250c849925af?raw)