---
title: "Live and recent matches for a sport"
method: GET
path: "/api/widget/matches/"
tags: ["matches"]
---

# Live and recent matches for a sport

`GET /api/widget/matches/`

## Request

- Base URL: `https://sportscore.com`
- URL: `https://sportscore.com/api/widget/matches/`
- Auth: none declared

## Query parameters

- `sport` 'football' | 'basketball' | 'cricket' | 'tennis', required
- `limit` integer

## Response `200`

Match list

- MatchesEnvelope
  - `sport` string
  - `count` integer
  - `matches` MatchSummary[]
    - `home` string
    - `away` string
    - `home_logo` string, uri
    - `away_logo` string, uri
    - `home_score` integer
    - `away_score` integer
    - `status` string
    - `status_text` string
    - `time` string, date-time
    - `slug` string
  - `updated` string, date-time

## Other responses

- `400`: Unknown sport

---

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