---
title: "Match Facts by League ID"
method: GET
path: "/football/match-facts/leagues/{leagueId}"
tags: ["Match Facts"]
---

# Match Facts by League ID

`GET /football/match-facts/leagues/{leagueId}`

## Request

- Base URL: `https://api.sportmonks.com/v3`
- URL: `https://api.sportmonks.com/v3/football/match-facts/leagues/{leagueId}`
- Auth: one of:
  - API key in query parameter `api_token`
  - API key in header `Authorization`

Returns all match facts available by league ID within your subscription. For more information, please visit:https://docs.sportmonks.com/football/endpoints-and-entities/endpoints/match-facts-beta/get-match-facts-by-league-id

[Sportmonks documentation](https://docs.sportmonks.com/football/endpoints-and-entities/endpoints/match-facts-beta/get-match-facts-by-league-id)

## Path parameters

- `leagueId` integer, required

## Query parameters

- `include` string
- `select` string[]
- `sortBy` string[]
- `filters` string
- `locale` string
- `order` 'asc' | 'desc'
- `per_page` integer
- `page` integer

## Response `200`

Success.

- object
  - `data` MatchFact[], required
    - `id` integer
    - `sport_id` integer
    - `fixture_id` integer
    - `type_id` integer
    - `participant` string
    - `basis` string
    - `data` object
      - `win` object
        - `all` object
          - `count` integer
          - `percentage` integer
        - `home` object
          - `count` integer
          - `percentage` integer
        - `away` object
          - `count` integer
          - `percentage` integer
        - `context` object
          - `n_match_checked` integer
          - `similar_matches` integer
          - `first_match` string
      - `loss` object
        - `all` object
          - `count` integer
          - `percentage` integer
        - `home` object
          - `count` integer
          - `percentage` integer
        - `away` object
          - `count` integer
          - `percentage` integer
        - `context` object
          - `n_match_checked` integer
          - `similar_matches` integer
          - `first_match` string
      - `draw` object
        - `all` object
          - `count` integer
          - `percentage` integer
        - `home` object
          - `count` integer
          - `percentage` integer
        - `away` object
          - `count` integer
          - `percentage` integer
        - `context` object
          - `n_match_checked` integer
          - `similar_matches` integer
          - `first_match` string
      - `all` object
        - `streak` integer
        - `matches` integer
        - `count` integer
        - `percentage` number
        - `average` number
      - `home` object
        - `streak` integer
        - `matches` integer
        - `count` integer
        - `percentage` number
        - `average` number
      - `away` object
        - `streak` integer
        - `matches` integer
        - `count` integer
        - `percentage` number
        - `average` number
      - `count` integer
      - `streak` integer
      - `matches` integer
      - `0-0` integer
      - `0-1` integer
      - `0-2` integer
      - `0-3` integer
      - `0-7` integer
      - `1-0` integer
      - `1-1` integer
      - `1-2` integer
      - `1-3` integer
      - `2-0` integer
      - `2-1` integer
      - `2-4` integer
      - `3-0` integer
      - `3-1` integer
      - `3-3` integer
      - `4-0` integer
      - `4-3` integer
      - `4-2` integer
    - `natural_language` string, nullable
    - `category` string
    - `scope` string
  - `pagination` Pagination: Pagination metadata returned with collection responses.
    - `count` integer: Number of items in the current page.
    - `per_page` integer: Maximum items per page.
    - `current_page` integer: Current page number.
    - `next_page` string, nullable: URL of the next page, when available.
    - `has_more` boolean: True when more pages are available.
  - `subscription` SubscriptionInfo[]
    - `meta` SubscriptionMeta
      - `trial_ends_at` string, date-time, nullable
      - `ends_at` string, date-time, nullable
      - `current_timestamp` integer
      - `next_billing_cycle` string, nullable
    - `plans` SubscriptionPlan[]
      - `plan` string
      - `sport` string
      - `category` string
    - `add_ons` SubscriptionAddOn[]: Add-ons / trialing features for this account. Empty when none are attached.
      - `add_on` string: Add-on name; may include a trial-end suffix like ' - Trialing until 2026-05-31 13:19:52'.
      - `sport` string
      - `category` string: Add-on category (Predictions, Team rankings, Calls, …).
    - `widgets` SubscriptionWidget[]: Widget entitlements for this account. Empty when none are attached.
      - `widget` string: Widget name (e.g. 'Wesley van Rooij Widgets All').
      - `sport` string: Sport scope of the widget (e.g. 'Football').
  - `rate_limit` RateLimit: Rate-limit window metadata returned with every successful response.
    - `resets_in_seconds` integer
    - `remaining` integer
    - `requested_entity` string
  - `timezone` string, required

## Other responses

- `400`: Bad Request. Some part of the request is malformed.
- `401`: Unauthorized. The request is not authenticated (missing or invalid api_token).
- `403`: Forbidden. The endpoint or resource is not accessible from your subscription.
- `404`: Not Found. The endpoint or resource does not exist.
- `422`: Validation Error. Required parameters missing or malformed.
- `429`: Too Many Requests. Hourly request limit exceeded — see RateLimit metadata.
- `500`: Internal Server Error. An internal error has been logged for inspection.

---

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