Statorium Matches API
Access match data including live scores, results, schedules, lineups, and head-to-head information.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/statorium-matches-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Statorium Football Matches API
description: The Statorium Football API delivers comprehensive football/soccer data for over 200 leagues worldwide. The API provides live scores, match results, standings, fixtures, lineups, player and team statistics, head-to-head records, league logos, and translated player and team names. All responses are in JSON format and require an API token for authentication.
version: 1.0.0
contact:
name: Statorium Support
url: https://statorium.com/
termsOfService: https://statorium.com/
servers:
- url: https://api.statorium.com/api/v1
description: Statorium API Server
security:
- apiKey: []
tags:
- name: Matches
description: Access match data including live scores, results, schedules, lineups, and head-to-head information.
paths:
/matches/:
get:
operationId: listMatches
summary: List Matches
description: Returns matches filtered by league, season, team, or date. Supports live score updates, scheduled fixtures, and completed results.
tags:
- Matches
parameters:
- $ref: '#/components/parameters/ApiKeyParam'
- name: leagueId
in: query
required: false
schema:
type: integer
description: Filter matches by league ID.
- name: seasonId
in: query
required: false
schema:
type: integer
description: Filter matches by season ID.
- name: teamId
in: query
required: false
schema:
type: integer
description: Filter matches involving a specific team.
- name: date
in: query
required: false
schema:
type: string
format: date
description: Filter matches by date (YYYY-MM-DD).
- name: status
in: query
required: false
schema:
type: string
enum:
- live
- scheduled
- finished
description: Filter matches by status.
responses:
'200':
description: List of matches
content:
application/json:
schema:
type: object
properties:
matches:
type: array
items:
$ref: '#/components/schemas/Match'
'401':
$ref: '#/components/responses/Unauthorized'
/matches/{matchId}/:
get:
operationId: getMatch
summary: Get Match by ID
description: Retrieves full details for a specific match including score, lineups, events, statistics, and head-to-head history between the two teams.
tags:
- Matches
parameters:
- $ref: '#/components/parameters/ApiKeyParam'
- name: matchId
in: path
required: true
schema:
type: integer
description: The unique identifier of the match.
responses:
'200':
description: Match details with lineups and statistics
content:
application/json:
schema:
$ref: '#/components/schemas/MatchDetail'
'401':
$ref: '#/components/responses/Unauthorized'
'404':
$ref: '#/components/responses/NotFound'
components:
schemas:
MatchDetail:
allOf:
- $ref: '#/components/schemas/Match'
- type: object
properties:
homeLineup:
type: array
items:
$ref: '#/components/schemas/LineupPlayer'
description: Home team lineup.
awayLineup:
type: array
items:
$ref: '#/components/schemas/LineupPlayer'
description: Away team lineup.
events:
type: array
items:
$ref: '#/components/schemas/MatchEvent'
description: Match events (goals, cards, substitutions).
statistics:
$ref: '#/components/schemas/MatchStatistics'
headToHead:
type: array
items:
$ref: '#/components/schemas/Match'
description: Previous matches between the two teams.
MatchStatistics:
type: object
description: Match statistics for both teams.
properties:
homePossession:
type: number
description: Home team ball possession percentage.
awayPossession:
type: number
description: Away team ball possession percentage.
homeShots:
type: integer
description: Total shots by home team.
awayShots:
type: integer
description: Total shots by away team.
homeShotsOnTarget:
type: integer
description: Shots on target by home team.
awayShotsOnTarget:
type: integer
description: Shots on target by away team.
homeCorners:
type: integer
description: Corners by home team.
awayCorners:
type: integer
description: Corners by away team.
MatchEvent:
type: object
description: An event that occurred during a match.
properties:
minute:
type: integer
description: Minute of the match when the event occurred.
type:
type: string
enum:
- goal
- yellow_card
- red_card
- substitution
- penalty
description: Type of match event.
playerId:
type: integer
description: ID of the player involved in the event.
teamId:
type: integer
description: ID of the team involved.
Match:
type: object
description: A football match with score and basic information.
properties:
id:
type: integer
description: Unique identifier for the match.
homeTeam:
$ref: '#/components/schemas/TeamRef'
awayTeam:
$ref: '#/components/schemas/TeamRef'
homeScore:
type: integer
description: Home team score.
awayScore:
type: integer
description: Away team score.
status:
type: string
enum:
- live
- scheduled
- finished
description: Current match status.
matchDate:
type: string
format: date-time
description: Date and time of the match.
leagueId:
type: integer
description: ID of the league this match belongs to.
seasonId:
type: integer
description: ID of the season this match belongs to.
minute:
type: integer
description: Current match minute (for live matches).
TeamRef:
type: object
description: A lightweight team reference.
properties:
id:
type: integer
description: Team identifier.
name:
type: string
description: Team name.
nameTranslated:
type: string
description: Translated team name if available.
LineupPlayer:
type: object
description: A player in a match lineup.
properties:
playerId:
type: integer
description: Player identifier.
name:
type: string
description: Player name.
position:
type: string
description: Player position.
shirtNumber:
type: integer
description: Shirt number worn in this match.
isStarting:
type: boolean
description: Whether the player is in the starting eleven.
responses:
Unauthorized:
description: Missing or invalid API key
content:
application/json:
schema:
type: object
properties:
error:
type: string
description: Error message describing the authentication failure.
NotFound:
description: Resource not found
content:
application/json:
schema:
type: object
properties:
error:
type: string
description: Error message indicating the resource was not found.
parameters:
ApiKeyParam:
name: apikey
in: query
required: true
schema:
type: string
description: Your Statorium API token for authentication.
securitySchemes:
apiKey:
type: apiKey
in: query
name: apikey
description: API token provided upon purchase of a data subscription. Include as query parameter in all requests.
externalDocs:
description: Statorium Football API Documentation
url: https://statorium.com/stats-api-documentation