Filters reference
This page consolidates every filter documented across individual endpoint pages into one place. For the underlying concepts (how static vs dynamic filters work, syntax rules), see the Filtering tutorial.
How to read this page
Static filters always work the same way, no custom options, fixed behaviour.
Dynamic filters are entity-based:
filters=<entityFilter>:<commaSeparatedIDs>, and can be chained with;.Dynamic filters that apply to an include (like
eventTypes) only work when that include is also requested.
Static filters
IdAfter
filters=IdAfter:{id}
Most list endpoints (fixtures, teams, players, referees, etc.)
Returns only records with an ID greater than the given ID, useful for incremental imports
todayDate
filters=todayDate
Fixtures
Filter fixtures to only those happening today
participantSearch
filters=participantSearch:{name}
Fixtures
Filter fixtures by participant (team) name
venues
filters=venues:{venueIDs}
Fixtures
Filter fixtures played at specific venues
deleted
filters=deleted:true
Fixtures and other syncable entities
Return only recently removed/deleted records, useful for keeping a local sync in step with removals
populate
filters=populate
Most list endpoints
Optimised bulk-fetch mode for database population, see the Rate Limit guide for details. Note: includes are disabled when this filter is active
Dynamic filters
fixtureLeagues
filters=fixtureLeagues:{leagueIDs}
Fixtures
Filter fixtures by league
fixtureSeasons
filters=fixtureSeasons:{seasonIDs}
Fixtures
Filter fixtures by season
fixtureStages
filters=fixtureStages:{stageIDs}
Fixtures
Filter fixtures by stage
fixtureGroups
filters=fixtureGroups:{groupIDs}
Fixtures
Filter fixtures by group
fixtureStates
filters=fixtureStates:{stateIDs}
Fixtures
Filter fixtures by state (e.g. only finished, only in-play)
eventTypes
filters=eventTypes:{typeIDs}
Fixtures with include=events
Return only specific event types (e.g. goals, cards)
statisticTypes
filters=fixtureStatisticTypes:{typeIDs}
Fixtures with include=statistics
Return only specific statistic types
periodStatisticTypes
filters=periodStatisticTypes:{typeIDs}
Fixtures with include=periods.statistics
Same as above, scoped to a period
lineupDetailTypes
filters=lineupdetailTypes:{typeIDs}
Fixtures with include=lineups.details
Filter lineup detail stats by type
coachCountries
filters=coachCountries:{countryIDs}
Fixtures/Teams with include=coaches
Filter coaches by country
teamStatisticSeasons
filters=teamStatisticSeasons:{seasonIDs}
Teams with include=statistics
Scope team statistics to specific seasons
teamStatisticDetailTypes
filters=teamStatisticDetailTypes:{typeIDs}
Teams with include=statistics.details
Filter team statistic detail types
playerStatisticSeasons
filters=playerStatisticSeasons:{seasonIDs}
Players/Squads with include=statistics
Scope player statistics to specific seasons
playerPositions
filters=playerPositions:{positionIDs}
Squads with include=player.position
Filter squad members by position
refereeStatisticSeasons
filters=refereeStatisticSeasons:{seasonIDs}
Referees with include=statistics
Scope referee statistics to specific seasons
refereeStatisticDetailTypes
filters=refereestatisticdetailTypes:{typeIDs}
Referees with include=statistics.details
Filter referee statistic detail types
seasonStatisticTypes
filters=seasonStatisticTypes:{typeIDs}
Seasons/Standings/Topscorers with include=season.statistics
Filter season-level statistics by type
seasontopscorerTypes
filters=seasontopscorerTypes:{typeIDs}
Topscorers
Filter topscorer categories (goals, assists, cards)
markets
filters=markets:{marketIDs}
Odds endpoints with include=odds
Filter odds by market
bookmakers
filters=bookmakers:{bookmakerIDs}
Odds endpoints with include=odds
Filter odds by bookmaker
Combining filters
Chain multiple dynamic filters with ;:
Related pages
Filtering tutorial - concepts and syntax rules
Selecting fields - reduce payload size alongside filtering
Rate Limit guide - the
populatefilter and its trade-offs
Last updated
Was this helpful?