---
title: "Search historical football matches"
method: GET
path: "/v1/predictions/football/search"
tags: ["predictions"]
---

# Search historical football matches

`GET /v1/predictions/football/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/football/search`
- Auth: none declared

Filters operate as AND. Team filter performs a case-insensitive partial match on home_team / away_team across the league table(s). Without ``league``, all 12 tables (5 top flights + 7 second divisions) are queried and merged. Use this to discover ``match_id`` values for ``GET /v1/predictions/football/{match_id}``.

## Query parameters

- `team` string, nullable
- `league` 'serie_a' | 'premier_league' | 'la_liga' | 'bundesliga' | 'ligue_1' | 'championship' | 'league_one' | 'league_two' | 'segunda_division' | 'ligue_2' | 'bundesliga_2' | 'serie_b'
- `season` string, nullable: Season string as stored, e.g. "2025_2026".
- `from` string, date, nullable
- `to` string, date, nullable
- `limit` integer
- `offset` integer

## Headers

- `authorization` string, nullable

## Response `200`

Successful Response

- FootballSearchResponse
  - `matches` FootballSearchMatch[], required
    - `match_id` string, required
    - `sport` 'football'
    - `league` string, required
    - `prediction_date` string, date, required
    - `season` string, required
    - `home_team` string, required
    - `away_team` string, required
  - `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)