Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Docs

Competitor vs Competitor

Beach Soccer Competitor vs Competitor provides previous and upcoming matches between two competitors, including scoring information.

Log in to see full request history

⏱️

Update Frequency

60s Time To Live / Cache



Data Points

Category & Sport:
AttributeParent ElementTypeDescription
country_codesport_event_context - categoryStringCountry code for a sport event's category
idsport_event_context - categoryStringUnique category ID for a sport event
ex. sr:category:577 (International)
namesport_event_context - categoryStringName for a sport event's category
ex. International
idsport_event_context - sportStringUnique sport ID for a sport event
ex. sr:sport:60
namesport_event_context - sportStringName for a sport event's sport
ex. Beach Soccer
Competition:
AttributeParent ElementTypeDescription
gendersport_event_context - competitionStringGender for a competition
ex. men, women
idsport_event_context - competitionStringUnique ID for a competition
ex. sr:competition:1068 (Euro Beach Soccer League)
namesport_event_context - competitionStringName of a competition
ex. Euro Beach Soccer League
parent_idsport_event_context - competitionStringUnique parent ID for a competition
Groups:
AttributeParent ElementTypeDescription
idsport_event_context - groups - groupStringUnique ID for a sport event's group
ex. sr:league:87579 (Euro Beach Soccer League 2024, Group A)
namesport_event_context - groups - groupStringName of a sport event's group
ex. Euro Beach Soccer League 2024, Group A
group_namesport_event_context - groups - groupStringAbbreviated name of a sport event's group
ex. A
Rounds:
AttributeParent ElementTypeDescription
competition_sport_event_numbersport_event_context - roundIntegerSport event number within a competition. Used for competitions that have fixed match numbers.
cup_round_idsport_event_context - roundStringUnique ID for a sport event's cup round
ex. sr:cup_round:2045639
cup_round_number_of_sport_eventssport_event_context - roundIntegerNumber of events in a sport event's round
cup_round_sport_event_numbersport_event_context - roundIntegerNumber within the cup_round of a match ID. For example, 1st leg of 2
namesport_event_context - roundStringName of a match's round
ex. quarterfinal or final
numbersport_event_context - roundIntegerNumber of a match's round
other_sport_event_idsport_event_context - roundStringA linked sport event ID, typically in a two-legged tie
ex. sr:sport_event:47395897
Season:
AttributeParent ElementTypeDescription
competition_idsport_event_context - seasonStringUnique ID for the competition a season belongs to
ex. sr:competition:1068 (Euro Beach Soccer League)
disabledsport_event_context - seasonBooleanSignifies a season has been disabled when true
end_datesport_event_context - seasonDateEnd date of a season
ex. 2025-07-13
idseasonStringUnique ID for a season
ex. sr:season:123583 (Euro Beach Soccer League 2024)
namesport_event_context - seasonStringName of a season
ex. Euro Beach Soccer League 2024
start_datesport_event_context - seasonDateStart date of a season
ex. 2025-06-23
yearsport_event_context - seasonStringYear of a season
ex. 24/25 or 2024
Stages:
AttributeParent ElementTypeDescription
end_datesport_event_context - stageDateEnd date of a sport event's stage
ex. 2024-07-14
ordersport_event_context - stageIntegerOrder of a stage within a season
phaseName of a sport event's stage
ex. playoffs, regular season

See the enum_phase entry in our Beach Soccer OpenAPI spec for a complete list of valid phase enum values
start_datesport_event_context - stageDateStart date of a sport event's stage
ex. 2024-06-24
typesport_event_context - stageStringType of a match's stage
cup, league
yearsport_event_context - stageStringYear of a match's stage
ex. 23/24 or 2024
Competitor:

Competitor info is available at the top of each file and for each individual match.

AttributeParent ElementTypeDescription
abbreviationcompetitors - competitorStringAbbreviation for a competitor name
ex. ESP
countrycompetitors - competitorStringCountry of a competitor
ex. Spain
country_codecompetitors - competitorStringCountry code of a competitor
ex. ESP
gendercompetitors - competitorStringGender of a competitor
ex. male
idcompetitors - competitorStringUnique ID for a competitor
ex. sr:competitor:38841
namecompetitors - competitorStringName for a competitor
ex. Spain
qualifiercompetitors - competitorStringDesignation of a competitor for a match
home, away
virtualcompetitors - competitorBooleanSignifies a competitor is virtual when true. Used for placeholder players/teams in TBD vs TBD matchups.
Coverage Properties:
AttributeParent ElementTypeDescription
livesport_event - coverageStringSignifies a sport event is covered live when true
Sport Event:
AttributeParent ElementTypeDescription
idsport_eventStringUnique ID of a match
ex. sr:sport_event:53617895
replaced_bysport_eventStringAn alternative sport event ID if the match is postponed and played at a later date
ex. sr:sport_event:51847153
resume_timesport_eventDateAn updated timestamp if there is a delay at the start or interruption during a match
ex. 2024-03-26T20:00:00+00:00
start_timesport_eventDateStart time of a match
ex. 2024-03-26T20:00:00+00:00
start_time_confirmedsport_eventBooleanSignifies the start time of a match is confirmed when true
Sport Event Status:
AttributeParent ElementTypeDescription
away_scoresport_event_statusIntegerTotal score for the away competitor in a match
away_normaltime_scoresport_event_statusIntegerScore for the away team in normal time
home_scoresport_event_statusIntegerTotal score for the home competitor in a match
home_normaltime_scoresport_event_statusIntegerScore for the home team in normal time
match_statussport_event_statusStringStatus within a match (sport event). Provides more detail on the state of a match when live than status
ex. not_started, interrupted, live, ended

See our FAQ for a complete list of statuses and their definitions.
scount_abandonedsport_event_statusBooleanSignifies a match was abandoned by a scout when true
statussport_event_statusStringStatus of a sport event
ex. not_started, live, ended, closed

See our FAQ for a complete list of statuses and their definitions.
winner_idsport_event_statusStringUnique ID of the match winner
ex. sr:competitor:98831
Period Scores:
AttributeParent ElementTypeDescription
away_scoresport_event_status - period_scores - period_scoreIntegerAway competitor period score
home_scoresport_event_status - period_scores - period_scoreIntegerHome competitor period score
numbersport_event_status - period_scores - period_scoreIntegerPeriod number
typesport_event_status - period_scores - period_scoreStringPeriod type
ex. regular_period, overtime
Path Params
string
required
Defaults to trial

The access level of your API key

string
required
Defaults to en

2 letter code for supported languages

en (English)

English is the only fully supported language for this API. Click here for valid language codes and a tabular list of available languages per competition.

string
required
Defaults to sr:competitor:38841

ID of a given competitor

string
required
Defaults to sr:competitor:71552

ID of a given competitor

string
required
Defaults to json

Format returned

Response

Language
Credentials
Click Try It! to start a request and see the response here! Or choose an example:
application/json