---
title: "Fetch per-metric data-quality completion percentages for a league scope."
method: GET
path: "/api/league/statistics/completion"
tags: ["League"]
---

# Fetch per-metric data-quality completion percentages for a league scope.

`GET /api/league/statistics/completion`

## Request

- Base URL: `https://api.sponsorunited.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.sponsorunited.com/api/league/statistics/completion`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/sponsorunited/apis/sponsorunited-api/docs/api/league/statistics/completion/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns, for each metric, the percentage of properties in the scope whose value is neither zero nor more than 25% below the league value. Computed over the full population server-side so it stays correct when the deals list is paginated. Scope matches /api/league/statistics; season is required; at least one of league_ids or scouting_markets must be provided.

## Query parameters

- `league_ids` integer[]
- `scouting_markets` integer[]
- `season` integer, required

## Response `200`

Successful response.

- object
  - `completion` object: Percentage (0-100) of properties that are healthy for each metric.
    - `companies_total` integer
    - `sponsor_companies` integer
    - `sponsor_in_venue` integer
    - `tv_companies` integer
    - `radio_companies` integer
    - `social_companies` integer
    - `digital_companies` integer
    - `vendor_companies` integer
    - `sponsor_subcategories_count` integer
  - `total_properties` integer: Number of properties in the scope the percentages were computed over.

## Other responses

- `422`: Validation failed. Season missing, neither league_ids nor scouting_markets provided, or invalid parameters.

---

[API](https://skmtc.dev/sponsorunited/apis/sponsorunited-api.md) - [All operations](https://skmtc.dev/sponsorunited/apis/sponsorunited-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sponsorunited/apis/sponsorunited-api/revisions/cbf1ca5bff8f?raw)