Utilities
Echo
Test request/response
Status
Generate HTTP status codes
Delay
Test response delays
Middleware
Test middleware parameters
Chaos
Chaos engineering tests
Resources
Browse Resources
Test 100+ API endpoints
Playground/Resources/Match

matches

sports

Sports match or game with teams, scores, sport type, league, venue, status, match date, and attendance. Used for sports databases, match tracking, and sports management systems.

Request Builder

https://api.mockly.codes/matches?page=1&limit=10&count=10

Configure your request and click Send Request to see the response here.

Endpoints

GET/matches

Get a collection of matches

Alternative: /sports/matches
GET/matches/:id

Get a single match by ID

Alternative: /sports/matches/:id
GET/matches/meta

Get resource metadata and schema

Alternative: /sports/matches/meta

How to Use Search

The search feature allows you to filter results by searching for text across all or specific fields. Choose between ?q= or ?search= parameter names.

1. Basic Search

Search across all text fields:

Basic Search
GET https://api.mockly.codes/matches?q=laptop

2. Search Specific Fields

Field-Specific Search
GET https://api.mockly.codes/matches?q=laptop&search_fields=name,description

Pro Tips

  • •Search is case-insensitive and performs partial matching
  • •Without search_fields, all text fields are searched
  • •Combine with pagination to handle large result sets efficiently

Code Examples

JavaScript

Fetch Collection
// Get 10 matches
fetch('https://api.mockly.codes/matches?count=10')
  .then(res => res.json())
  .then(data => console.log(data));

Python

Fetch with Requests
import requests

response = requests.get(
    'https://api.mockly.codes/matches?count=10'
)
data = response.json()

cURL

Command Line
curl "https://api.mockly.codes/matches?count=10"

Bypass Cache

Get Fresh Data
fetch('https://api.mockly.codes/matches?nocache=true')

Schema Properties

idinteger

Unique identifier for the match

Gen:random_int
home_teamstring

Name of the home team

Gen:team_name
away_teamstring

Name of the away team

Gen:team_name
home_scoreinteger

Score of the home team

Gen:random_int
away_scoreinteger

Score of the away team

Gen:random_int
sportstring

Sport type (e.g., Football, Basketball, Soccer, Tennis)

Gen:sport
leaguestring

League or competition name

Gen:league
stadiumstring

Name of the stadium or venue where the match is played

Gen:stadium
citystring

City where the match takes place

Gen:city
statusstring

Match status (e.g., scheduled, live, finished, postponed, cancelled)

Gen:match_status
match_datestring

Date and time when the match is scheduled or was played

Gen:future_datedate-time
attendanceinteger

Number of spectators who attended the match

Gen:random_int

Query Parameters

countinteger

Number of items to return (default: 10, max: 100)

seedinteger

Seed for reproducible data generation

nocacheboolean

Bypass cache and generate fresh data on every request