---
title: "The cards and narrative numbers of the Merge scans tab"
method: GET
path: "/analytics/v1/merge/cards"
tags: ["analytics"]
---

# The cards and narrative numbers of the Merge scans tab

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

Files merged, checked before merge (and the previous period), issues that reached the branch, and the outcome of the issues found in the editor: not merged, verified fixed, reached the branch. Organisation totals for 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 commit author, by email.

## Response `200`

Successful Response

- MergeCardsResponse: `GET /merge/cards` — functional §8.1 and §8.2.
  - `files_merged` integer, required: Merged-file rows of the period
  - `unmatched_files` integer, nullable: Only with `user_id`: merged files of the period whose commit author matches no workspace account
  - `repositories` integer, required: Distinct repositories of the merged files
  - `pushes` integer, required: Distinct push-triggered merge scans of the merged files
  - `checked` integer, required: Merged files whose state is `checked`
  - `checked_pct` integer, nullable, required: checked / files_merged, %; null without files
  - `previous_checked_pct` integer, nullable, required: The same share over the previous period of the same length; null without files
  - `reached` integer, required: Findings the completed push scans of the period marked as introduced
  - `reached_seen_first` integer, required: Issues found in the editor that the covering merge scan found again
  - `reached_not_seen` integer, required: reached - reached_seen_first, never below 0
  - `issues_found` integer, required: Issues found in the editor in the period = not_merged + verified_fixed + reached_seen_first
  - `base` integer, required: verified_fixed + reached_seen_first
  - `verified_fixed` integer, required: Issues whose file reached the branch and the merge scan did not report the rule
  - `fix_rate_verified_pct` integer, nullable, required: verified_fixed / base, %; null when base is 0
  - `not_merged` integer, required: Issues whose file no merge scan has covered since the check
  - `repos_without_merge_scan` integer, required: Repositories with merged files in the period and no completed push scan; left out of every issue figure

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