Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Docs

Match Lineups

Provides lineups and batting order for a given match.

⏱️

Update Frequency

30s Time To Live / Cache


Data Points

Category & Sport
AttributeParent ElementTypeDescription
country_codesport_event - tournament - categoryStringCountry code for a tournament's category
idsport_event - tournament - categoryStringUnique category ID for a tournament

ex. sr:category:105
namesport_event - tournament - categoryStringName for a tournament's category

ex. International
idsport_event - tournament - sportStringUnique sport ID for a tournament

ex. sr:sport:21
namesport_event - tournament - sportStringName for a tournament's sport

ex. Cricket
Season
AttributeParent ElementTypeDescription
end_datesport_event - seasonDateEnd date of a sport event's season

ex. 2024-06-17
idsport_event - seasonStringUnique ID for a sport event's season

ex. sr:season:122977 (Sheffield Shield 24/25)
namesport_event - seasonStringName of a sport event's season

ex. Sheffield Shield 24/25
start_datesport_event - seasonDateStart date of a sport event's season

ex. 2023-09-23
tournament_idsport_event - seasonStringUnique tournament ID for a sport event's season

ex. sr:tournament:21568 (Sheffield Shield)
yearsport_event - seasonStringYear of a sport event's season

ex. 23/24 or 2024
Tournament
AttributeParent ElementTypeDescription
gendersport_event - tournamentStringGender of a sport event's tournament

men, women, mixed
idsport_event - tournamentStringUnique ID for a sport event's tournament

ex. sr:tournament:21568 (Sheffield Shield)
namesport_event - tournamentStringName of a sport event's tournament

ex. Sheffield Shield
typesport_event - tournamentStringType of a sport event's tournament

test, odi, t10, t20i, first_class, list_a, t20, the_hundred
namesport_event - tournament_roundStringName of a sport event's tournament round
numbersport_event - tournament_roundIntegerNumber of a sport event's tournament round
typesport_event - tournament_roundStringType of a sport event's tournament round

ex. group
Competitor
AttributeParent ElementTypeDescription
abbreviationcompetitors - teamStringAbbreviation for a competitor name

ex. BUL (Queensland Bulls)
countrycompetitors - teamStringCountry of a competitor

ex. Australia
country_codecompetitors - teamStringCountry code of a competitor

ex. AUS (Australia)
gendercompetitors - teamStringGender for a competitor

male, female
idcompetitors - teamStringUnique ID for a competitor

ex. sr:competitor:142678 (Queensland Bulls)
namecompetitors - teamStringName for a competitor

ex. Queensland Bulls
qualifiercompetitors - teamStringDesignation of a competitor for a sport event

home, away
virtualcompetitors - teamBooleanSignifies a competitor is a virtual team whan true. Used for placeholder teams in TBD vs TBD matchups.
teamlineups - lineupStringLineup designation for a team

home, away
Player
AttributeParent ElementTypeDescription
country_codestarting_lineup - playerStringCountry code of a player

ex. BGD (Bangladesh)
date_of_birthstarting_lineup - playerDateDate of birth of a player

ex. 1993-02-25
idstarting_lineup - playerStringUnique ID of a player

ex. sr:player:696896
namestarting_lineup - playerStringName of a player

ex. Sarkar, Soumya
nationalitystarting_lineup - playerStringNationality of a player

ex. Bangladesh
orderstarting_lineup - playerIntegerBatting order number of a player for a match
typestarting_lineup - playerStringPosition of a player

ex. wicket_keeper, all_rounder, batsman, bowler
Sport Event
AttributeParent ElementTypeDescription
idsport_eventStringUnique ID of a sport event

ex. sr:sport_event:52962997
scheduledsport_eventDate-timeScheduled start time of a match

ex. 2025-02-08T00:00:00+00:00
start_time_tbdsport_eventBooleanSignifies the start time of a match is TBD when true
statussport_eventStringStatus of a match.

See our FAQ for a complete list of statuses and their definitions
Sport Event Conditions
AttributeParent ElementTypeDescription
day_nightsport_event_conditionsStringSignifies a day or night match

day, night
neutral_venuesport_event_conditionsBooleanSignifies a match is played at a neutral site when true
typesport_event_conditionsStringType of a match

test, odi, t10, t20i, first_class, list_a, t20
rain_conditionssport_event_conditions - weather_infoStringRain conditions for a match

no_rain, expected_soon, showers, rain, heavy_rain, unknown
sky_conditionssport_event_conditions - weather_infoStringSky conditions for a match

clear, partly_cloudy, cloudy, overcast, unknown
temperature_rangesport_event_conditions - weather_infoStringTemperature range for a match

very_hot, hot, warm, mild, cold, very_cold, unknown
wind_conditionssport_event_conditions - weather_infoStringWind conditions for a match

no_wind, breeze, windy, gale, unknown
boundary_positionsport_event_conditions - pitch_infoStringBoundary position of the pitch for a match

in, normal, unknown
grass_coversport_event_conditions - pitch_infoStringGrass cover of the pitch for a match

barren, normal, green, unknown
pitch_moisturesport_event_conditions - pitch_infoStringMoisture of the pitch for a match

very_dry, dry, normal, moist, unknown
pitch_qualitysport_event_conditions - pitch_infoStringQuality of the pitch for a match

normal, delayed, deteriorating, slow, low, unknown
outfield_conditionssport_event_conditions - outfield_infoStringOutfield conditions for a match

slow, normal, fast
Venue
AttributeParent ElementTypeDescription
capacityvenueIntegerCapacity of a venue

ex. 22500
city_namevenueStringCity name of a venue

ex. Sylhet
country_codevenueStringCountry code of a venue

ex. BGD (Bangladesh)
country_namevenueStringCountry name of a venue

ex. Bangladesh
idvenueStringUnique ID of a venue

ex. sr:venue:24744
map_coordinatesvenueStringCoordinates of a venue

ex. 24.920781,91.868653
namevenueStringName of a venue

ex. Sylhet International Cricket Stadium
timezonevenueStringTimezone of a venue

ex. Asia/Kolkata
statevenueStringState of a venue

ex. Sylhet International Cricket Stadium
namevenue - bowling_endStringName of a venue bowling end

ex. Anna Pavilion End, V Pattabhiraman Gate End
Language
Credentials
Query
Click Try It! to start a request and see the response here!