---
title: "Check volume trends: live checks per ISO week, by client"
method: GET
path: "/analytics/v1/live/trends"
tags: ["analytics"]
---

# Check volume trends: live checks per ISO week, by client

`GET /analytics/v1/live/trends`

## 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/trends`
- Auth: one of:
  - HTTP bearer
  - OpenID Connect (`https://account.qualityclouds.com//realms/ai-production/.well-known/openid-configuration`)

One item per ISO week (UTC) of the period, weeks without a check included; the last one is the week in progress (partial). Every client is returned. The totals sum to card 1. Organisation totals; all four filters apply.

## 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

- LiveTrendsResponse: `GET /live/trends` — one item per ISO week of the period, empty weeks included.
  - `items` TrendWeekResponse[], required
    - `week` string, required: ISO week label, e.g. '2026-W37'
    - `week_start` string, required: Monday 00:00 UTC of that week, ISO-8601
    - `partial` boolean, required: True for the week in progress
    - `total` integer, required: Live checks of the week; the bars sum to card 1
    - `by_client` object: Checks per client label, every client, most first

## 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)