---
title: "Search the published Champions League record"
method: GET
path: "/v1/predictions/champions/search"
tags: ["predictions"]
---

# Search the published Champions League record

`GET /v1/predictions/champions/search`

## Request

- Base URL: `https://api.predixsport.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.predixsport.com/v1/predictions/champions/search`
- Auth: none declared

Searches every Champions League match this service has published a prediction for, played or upcoming. `team` is a substring match on the club name AS UEFA RECORDS IT, which is the native spelling: `Bayern München`, not `Bayern Munich`. Partial terms work and are the safe way to search — `bayern`, `zvezda`, `Žalgiris`. `season` is the UEFA seasonYear — the season ENDING year, so `2027` means the 2026-27 campaign. Qualifying-round ties never appear: they are outside the model's validated scope and are never published. Rows carry `actual_result` once the match has been played.

## Query parameters

- `team` string, nullable
- `season` string, nullable: UEFA seasonYear (season ENDING year), e.g. "2027".
- `from` string, date, nullable
- `to` string, date, nullable
- `limit` integer
- `offset` integer

## Headers

- `authorization` string, nullable

## Response `200`

Successful Response

- ChampionsSearchResponse
  - `matches` ChampionsSearchMatch[], required
    - `match_id` string, required
    - `sport` 'champions'
    - `competition` string
    - `season` string, required: UEFA seasonYear (season ENDING year): `2027` = 2026-27.
    - `match_date` string, date, required
    - `stage` string, nullable
    - `home_team` string, required
    - `away_team` string, required
    - `actual_result` string, nullable: Realised 90-minute outcome once played: H, D or A. `null` while the match is still upcoming. A tie decided on penalties is a D here — that is what the 1X2 market and the model both mean.
  - `count` integer, required
  - `has_more` boolean, required

## Other responses

- `422`: Validation Error

---

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