---
title: "List league deals per property with aggregated statistics."
method: GET
path: "/api/league/deals"
tags: ["League"]
---

# List league deals per property with aggregated statistics.

`GET /api/league/deals`

## 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/deals`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/sponsorunited/apis/sponsorunited-api/docs/api/league/deals/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns deal statistics for each property (team) matching the provided filters. When use_new_behavior is true the response is a paginated envelope; otherwise it returns all matching properties plus league-level statistics.

## Query parameters

- `season` integer, required
- `status` string[]
- `platform_id` integer
- `subplatform_id` integer
- `item_id` integer
- `leagues` integer[]
- `scouting_groups` integer[]
- `scouting_markets` integer[]
- `properties` integer[]
- `scouting_market_owners` integer[]
- `divisions` integer[]
- `sort_by` 'name' | 'owner' | 'division' | 'companies_total' | 'sponsor_companies' | 'sponsor_in_venue' | 'tv_companies' | 'radio_companies' | 'social_companies' | 'digital_companies' | 'vendor_companies' | 'sponsor_subcategories_count'
- `sort_order` 'asc' | 'desc'
- `with_assets_count_by_audit_status` boolean
- `use_new_behavior` boolean
- `per_page` integer
- `page` integer

## Response `200`

Successful response. Returns deal statistics per property; shape depends on use_new_behavior.

## Other responses

- `422`: Validation failed. The season parameter is required.

---

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