SportAPI Documentation
EN
S Product documentationSport Line API
v1
Service & pricing ↗ Get access ↗
Sport Line API / Field Reference

Sport Line API Field Reference

This reference contains request parameters and JSON fields confirmed by actual Sport Line API responses.

For relationships between fields and differences between match objects returned by different methods, see Match Data Model.

If the Description cell is empty, the purpose of that field has not yet been confirmed. Do not interpret such values independently. A description will be added after the API developer or owner provides clarification.

Request Parameters

ParameterLocationTypeValues or formatDescription
PackageHTTP headerstringClient API keyAuthentication key
typeURLstringlive, lineSports line type
langURLstringFor example, ru, enResponse language available in the client’s subscription
sportIdURLnumberSport IDRetrieved from menu or sports
countryIdURLnumberCountry IDRetrieved from menu or countries
tournamentIdURLnumberTournament ID; 0 means all tournaments for the sportRetrieved from menu or tournaments
gameIdURLnumberMatch IDRetrieved from events
textURLstringTeam name or part of itSearch text for the search method; it must be URL-encoded
formatURLstringsub for events; group for eventsub groups matches by tournament; group arranges a specific match’s odds into markets and columns and sorts them by value
countURLnumberPass 50Originally controlled the number of records returned, but the limit has been removed. The API returns all available matches in the selected scope
cybersportquery parameterbooleantrue, falseSwitches to esports data in methods that support this parameter
fullquery parameterbooleantrue, false; default is falseIn topmatches and toplist, switches from a short summary to an extended match object. It does not return the full odds list

Standard Successful Response

Rules for processing successful responses, empty result sets, service messages, and errors are documented in Sport Line API Response Format.

FieldTypeMethodsValues or formatDescription
statusnumberall documented methods1 in successful responsesRequest status
pagestringall documented methodsFor example, /v1/menu, /v1/events, /v1/event, /v1/toplist, /v1/search; topmatches currently returns /v1/topmathesName of the method that generated the response
bodyarray or objectall documented methodsDepends on the methodMain response data

API Error

FieldTypeMethodsValues or formatDescription
error_codenumberall methodsFor example, 90, 100Error category code
error_messagestringall methodsError textCause of the error

Sport

This object is returned by sports and at the top level of menu.

FieldTypeValues or formatDescription
idnumberSport IDUsed as sportId in the URL
namestringName in the requested languageSport name
counternumberInteger starting from 0Number of available matches for this sport
subarrayOnly in menuCountries for the selected sport

Standard icon:

https://cdn.sportapi.net/sports/v1/color/{id}.webp

Country

This object is returned by countries and inside a sport object in menu.

FieldTypeValues or formatDescription
idnumberCountry IDUsed as countryId in the URL
namestringName in the requested languageCountry name
sport_idnumberSport IDSport to which the country selection belongs
counternumberInteger starting from 0Number of available matches for the selected sport in this country
subarrayOnly in menuTournaments for the selected country

Standard icon:

https://cdn.sportapi.net/flags/v1/color/{id}.webp

Tournament in Navigation Methods

This object is returned by tournaments and inside a country object in menu.

FieldTypeValues or formatDescription
idnumberTournament IDUsed as tournamentId in the URL
namestringName or an empty stringTournament name
counternumberInteger starting from 0Number of available tournament matches
sport_idnumberSport IDTournament’s sport
countryIdnumberCountry IDTournament’s country

Standard icon:

https://cdn.sportapi.net/tournaments/v1/color/{id}.webp

Tournament in an events Response

FieldTypeValues or formatDescription
tournament_idnumberTournament IDTournament identifier
tournament_namestringName in the requested languageTournament name
events_listarrayMatch arrayTournament matches

Match: Identifiers and Placement

The short match fields in this section are also used by the search response. Search returns a flat match array without odds.

FieldTypeValues or formatDescription
sgame_idstringString IDReserved test field for match, team, and player statistics. It is not currently used by the API
stat_idstringString IDReserved test field for detailed statistics. It is not currently used by the API
game_idnumberNumeric IDMatch ID used to request event
game_midnumber or nullNumeric ID or nullMain match ID. A submatch has its own game_id, while game_mid points to the main match
game_numnumberIntegerLegacy unused field. It is planned for removal from the API
game_startnumberUnix timestamp in secondsMatch start time
sport_idnumberSport IDMatch sport
sport_namestringName in the requested languageSport name
country_idnumberCountry IDMatch country
country_namestringName in the requested languageCountry name
tournament_idnumberTournament IDMatch tournament
tournament_namestringName in the requested languageTournament name
game_dop_namestringFor example, Corners, Yellow Cards, 1st HalfSubmatch type name
game_deskstringFor example, Half, Set, QuarterType of playing period

Important: a new game_id is generated for the Live version of a match. Prematch and Live matches cannot be linked using this field.

Do not treat sgame_id, stat_id, game_num, stat_list_extra, or game_plan as required parts of a client integration. They are legacy, test, or reserved fields. game_num is planned for removal from the API.

Match: Teams or Participants

FieldTypeValues or formatDescription
opp_1_namestringNameFirst team or participant
opp_2_namestringNameSecond team or participant
opp_1_idnumberNumeric IDFirst team or participant ID
opp_2_idnumberNumeric IDSecond team or participant ID
opp_1_idsarray of numberID arrayParticipants on the first side when it consists of multiple players or teams, such as a tennis doubles pair or a group match
opp_2_idsarray of numberID arrayParticipants on the second side when it consists of multiple players or teams, such as a tennis doubles pair or a group match
opp_1_iconstringFile name, for example hash.pngFirst team or participant icon
opp_2_iconstringFile name, for example hash.pngSecond team or participant icon

To retrieve a standard icon, remove the extension from opp_1_icon or opp_2_icon and insert the remaining name into the URL:

https://cdn.sportapi.net/opp/v1/color/{iconName}.webp

Match: Short Betting List

FieldTypeValues or formatDescription
game_oc_counternumberInteger starting from 0Total number of available betting selections or outcomes for the match
game_oc_listarrayMarket arrayShort list of main markets and best odds in events, topmatches?full=true, and toplist?full=true

The set of markets and selections depends on the sport. Retrieve the complete selection list through event using game_id.

Betting Market in game_oc_list

FieldTypeValues or formatDescription
group_idnumberMarket IDBetting market identifier
group_namestringName in the requested languageBetting market name
columnsnumberIntegerRecommended number of display columns. It does not have to equal the number of nested arrays in oc_list
oc_listarrayIn events, topmatches?full=true, and toplist?full=true: a selection array; in event: an array of arraysIn event, each nested array represents one selection column in the group format

In the group format, the API has already arranged the data into columns and sorted it by value. Preserve the API order instead of regrouping or re-sorting selections on the client side.

Selection in oc_list

Practical rules for using these fields and real examples of different bet types are documented in Odds and Betting Market Data Model.

FieldTypeValues or formatDescription
oc_group_namestringName in the requested languageBetting market name
oc_namestringName in the requested languageSelection name
oc_ratenumberDecimal numberOdds
oc_sizestring or numberFor example, 0, "2.5", "-0.25"Handicap, total, or another parameter value
oc_pointerstringComposite string IDPrimary unique code of the bet or selection. It is passed to the separate bet placement and settlement system when that service is connected. For player-specific selections, also account for op_id
oc_blockbooleantrue, falsetrue means the selection is blocked; false means it is available
op_idnumber or nullID or nullPlayer or participant ID for a player-specific selection, when applicable

Match: Score, Period, and Additional Data

FieldTypeValues or formatDescription
timernumberWhole seconds; usually 0 in PrematchMatch timer. Divide the value by 60 to obtain minutes
score_fullstringFor example, "1:0"Overall score
score_periodstringScore or an empty stringCurrent-period score
score_extrastringFor example, "0:15" or an empty stringTennis game score. It is primarily used in tennis and may occur in similar formats, including esports tennis
period_namestringName or an empty stringCurrent match period
extra_timestringFor example, "+10" or an empty stringNumber of added minutes
finaleboolean or nulltrue, false, nullIndicates that the match has ended. This field is not available for every match
pitchstringID or an empty stringID of the participant serving in applicable sports
stat_listarrayStatistics arrayMatch statistics
stat_list_extraarrayArrayReserved test field for additional match details. It is not currently used
sub_gamesarraySubmatch arrayReturns [] in events, topmatches?full=true, and toplist?full=true. In a specific event, it contains links to submatches but not their odds
event_planarrayObject arrayReturns [] in events, topmatches?full=true, and toplist?full=true. The full list of home-side and away-side teams in a group match is available only in a specific event
game_planany JSON value or nullnull in actual examplesReserved test field for match details such as a tournament stage or court type. It is not currently used

Statistics Entry in stat_list

Processing rules, real examples, and confirmed statistic IDs are documented in Live Match Statistics Data Model.

FieldTypeValues or formatDescription
idnumberStatistic IDStatistic identifier
namestringName in the requested languageStatistic name
opp1stringNumber or another value represented as a stringValue for the first team or participant
opp2stringNumber or another value represented as a stringValue for the second team or participant

Submatch in sub_games

The complete process for retrieving and opening additional matches is documented in Additional Matches and Submatches.

FieldTypeValues or formatDescription
game_idnumber or nullID or nullSub-event ID
game_numnumber or nullNumber or nullLegacy unused field. It is planned for removal from the API
game_namestring or nullName or nullSub-event name

sub_games contains links to separate submatch types: periods, corners, cards, fouls, player statistics, and other available options.

In an events list, the field is returned as an empty array:

"sub_games": []

The events method does not use sub_games; it returns only [] here. The list is available when requesting a specific match through event. Each item contains game_id, game_num, and game_name. To retrieve a submatch’s odds, make a separate event request using its game_id.

Object in event_plan

The events method does not use event_plan and returns only [] here. A populated field is available in a specific event response for a group match. The main match may be named “Home — Away,” while the array contains the complete list of actual teams on both sides. Each object describes a pair of teams and the time of their meeting.

FieldTypeValues or formatDescription
opp_1_namestringNameTeam on the home side
opp_2_namestringNameTeam on the away side
opp_1_idnumber or nullID or nullHome-side team ID
opp_2_idnumber or nullID or nullAway-side team ID
opp_1_country_idnumber or nullID or nullCountry ID of the home-side team
opp_2_country_idnumber or nullID or nullCountry ID of the away-side team
opp_1_iconstringFile nameHome-side team icon
opp_2_iconstringFile nameAway-side team icon
opp_1_datenumber or nullUnix timestamp or nullDate and time associated with the home-side team
opp_2_datenumber or nullUnix timestamp or nullDate and time associated with the away-side team
game_startnumber or nullUnix timestamp or nullStart time of this pair’s meeting

Video and Live 3D Tracker

Detailed rules:

FieldTypeValues or formatDescription
vistring or nullID or nullLive match video stream ID
zpnumber or nullID or nullLive 3D Tracker ID, passed to the tracker as gameid
vanumber or nullOnly 1 or null1 means video is available; null means no video is available. The value 0 is not used

If zp is null, Live 3D Tracker is not available for the match.