NIFS-API version 1.0 documentation

Changelog


January 2021



Resources


Sports

Methods:
GET, OPTION

Query parameters:
Url Description
sports/ List all Sports
sports/?languageCode=nb-NO List all Sports with norwegian names

Data:
Name Type Description
type String Value = "nifs:sport"
id Int  
uid String prefix = "sp"
name String  

Data returned:

Countries

Methods:
GET, OPTION

Query parameters:
Url Possible values Description
countries/   List all countries
countries/{$countryId}   One specific country. Linked example is Norway
countries/{$countryId}/matches?date=YYYY-mm-dd   All matches in a country on a particular date. Linked example is Norway on 2015-10-18.
countries/?hasTournaments=1 1 List all countries that have one or more visible tournament
countries/?withTournaments=1&withStages=1&level=2&fromYear=2015 1, 1, int < 10000, int List all countries with tournaments and stages where tournament level <= $level.
countries/?hasTeams=1 1 List all countries that have one or more teams
countries/?hasTeamsInCustomerStages=1 1 List all countries that have one or more teams that has participated in a stage chosen by at least one customer
countries/?hasTopScorer=1 1 List all countries that have one or more stage with top scorer data
countries/?hasCards=1 1 List all countries that have one or more stage with cards data
countries/?hasRatings=1 1 List all countries that have one or more stage with player ratings data
countries/?hasStagesWithTransfers=1 1 List all countries that have one or more stage with transfer data
countries/{$countryId}/tournaments   List all tournaments for a specific country. See Tournaments for more info. Linked example is Norway.

Data:
Name Type Comment
type String Value = "nifs:country" or "nifs:countryCompact" in compact mode
id Int  
uid String prefix = "cou" or "cou_c" in compact mode
name String Is also set in compact mode objects
shortName String ISO 3166 or Fifa Country Codes (https://en.wikipedia.org/wiki/List_of_FIFA_country_codes). No standard has been decided upon yet...
priority Int Should be used as general sorting order
countryType Enum(String) Possible values: Country, Confederation, Other
continent String Possible values: Europe, Asia, Africa, Oceania, North and Central America, South America, World
tournaments Tournament[] Optional. Only set when ?withTournaments=1&withStages=1&level=3 is used. See tournaments for more info.

Data returned:

Tournaments

Methods:
GET, OPTION

Query parameters:
Url Description
tournaments/ List all tournaments
tournaments/?sortBy=gender,level List all tournaments sorted. Possible values:
"gender,level" First male tournaments, then sorted on levels ascending.
"name" Sorted by name only.
tournaments/{$tournamentId} One specific tournament. Linked example is Tippeligaen
tournaments/{$tournamentId}/matches?date=YYYY-mm-dd One specific tournament. Linked example is Tippeligaen. Linked example is Tippeligaen on 2015-10-18.
tournaments/?hasStages=1 List all tournaments that have one or more visible stages
tournaments/?hasLeagues=1 List all tournaments that have one or more league stages
tournaments/?hasChampionships=1 List all tournaments that have one or more visible championships
countries/{$countriesId}/tournaments/?hasTopScorer=1 List all tournaments that have one or stage with top scorer data for a country. Linked example is Norway
countries/{$countriesId}/tournaments/?hasCards=1 List all tournaments that have one or stage with cards data for a country. Linked example is Norway
countries/{$countriesId}/tournaments/?hasRatings=1 List all tournaments that have one or stage with player ratings for a country. Linked example is Norway
countries/{$countriesId}/tournaments/?hasStagesWithTransfers=1 List all tournaments that have one or stage with transfer data for a country. Linked example is Norway
tournaments/{$tournamentId}/championships List all championships for a specific tournament. See championships for more info. Linked example is Copa América.
tournaments/{$tournamentId}/stages List all stages for a specific tournament. See stages for more info. Linked example is Tippeligaen.
Is to be deprecated in future versions of API.
tournaments/?inCustomerStages=1&withStagesAndTeams=1 List all tournaments with stages that are selected by at least one customer group. Include all active stages and the participating teams.

Data:
Name Type Description
type String Value = "nifs:tournament" or "nifs:tournamentCompact" in compact mode
id Int  
uid String prefix = "t" or "t_c" in compact mode
name String Is also set in compact mode objects
norwegianDescription String Optional. A short norwegian description of the tournament
gender Enum(String) possible values: "men", "women"
level Int  
country CountryCompact  
neutralVenues Boolean  
tournamentTypeId Enum(Int) possible values:
1 National team tournament - Example: FIFA World Cup
2 Club tournament - Example: Tippeligaen
3 International club tournament - Example UEFA Champions League
4 Club Friendlies - Example: Copa del Sol
5 National Team Friendlies - Example: 'Vennskapskamper'
6 Open - Example: 'Treningskamper'
7 Youth - Example: 'NM Junior'
tournamentCategoryId Enum(Int) possible values:
1 National league
2 International cup
3 National cup
4 National league cup
5 Super cup
6 Lower league cup
7 Regional League
8 Regional cup qualification
9 National cup qualification
10 National league cup qualification
11 Lower league cup qualification
12 Regional cup qualification
13 International cup qualification
30 International tournament
31 International regional tournament
32 International tournament qualification
33 International regional tournament qualification
99 Friendlies
100 Other
visibilityId Enum(Int) possible values:
1 Show for all
2 Show only on nifs.no
3 Show for some customers and on nifs.no - Not in use
4 Show for some customers but not on nifs.no - Not in use
5 Do not show
stages Stage[] Optional. Only set when ?inCustomerStages=1&withStagesAndTeams=1 is used. See stages for more info.
logo Image Optional. See image for more information.

Data returned:

Championships

Methods:
GET, OPTION

Query parameters:
Url Description
tournaments/{$tournamentId}/championships/ List all championships in tournament. Linked example is Copa America
tournaments/{$tournamentId}/championships/{$championshipId}/
or
championships/{$championshipId}/
One specific championship. Linked example is Copa América 2015
championships/{$championshipId}/stages/ List all stages in championship. Linked example is Copa America 2015. See stages for more info.

Data:
Name Type Description
type String Value = "nifs:championship" or "nifs:championshipCompact" in compact mode
id Int  
uid String prefix = "cha" or "cha_c" in compact mode
name String  
fullName String  
yearStart Int  
yearEnd Int  
tournament TournamentCompact Optional

Data returned:

Stages

Methods:
GET, OPTION

Query parameters:
Url Description
tournaments/{$tournamentId}/stages/ List all stages in a tournament. Linked example is Tippeligaen
tournaments/{$tournamentId}/stages/?onlyLeagues=1 List all league stages in a tournament. Linked example is Tippeligaen
tournaments/{$tournamentId}/stages/?hasTopScorer=1 List all stages with top scorer data for a tournament. Linked example is Tippeligaen
tournaments/{$tournamentId}/stages/?hasCards=1 List all stages with cards data for a tournament. Linked example is Tippeligaen
tournaments/{$tournamentId}/stages/?hasRatings=1 List all stages with player ratings data for a tournament. Linked example is Tippeligaen
tournaments/{$tournamentId}/stages/?hasTransfers=1 List all stages with transfer data for a tournament. Linked example is Tippeligaen
tournaments/{$tournamentId}/stages/?hasRobot=1 List all stages in a tournament who should get robot articles. Linked example is Tippeligaen
stages/?hasTransfers=1 List all current stages with transfer data.
stages/?hasRobot=1 List all current stages who should get robot articles.
tournaments/{$tournamentId}/stages/{$stageId}/
or
stages/{$stagesId}/
One specific stage. Linked example is Tippeligaen 2015
stages/?allMatchesCoveredLive=1 List all stages where all matches are covered live by NTB.
tournaments/{$tournamentId}/stages/{$stageId}/matches/
or
stages/{$stagesId}/matches/
List all matches for one specific stage. Linked example is Tippeligaen 2015. See matches for more info.
stages/{$stagesId}/matches/?teamId={$teamId} List all matches for one specific stage for a team. Linked example is Brann in Tippeligaen 2014. See matches for more info.
tournaments/{$tournamentId}/stages/{$stageId}/teams/
or
stages/{$stagesId}/teams/
List all teams participating in one specific stage. Linked example is Tippeligaen 2015. See teams for more info.
tournaments/{$tournamentId}/stages/{$stageId}/table/
or
stages/{$stagesId}/table/
Table for a stage. Linked example is Tippeligaen 2015. See table for more info.

Data:
Name Type Description
type String Value = "nifs:stage" or "nifs:stageCompact" in compact mode
id Int  
uid String prefix = "s" or "s_c" in compact mode
name String  
fullName String Is also set in compact mode objects
groupName String or null  
startYear Int  
endYear Int  
dateStart Date or null  
dateEnd Date or null This date is the date of the last known date in the stage. That means that for example in the Scottish Premiership where only 33 of 38 rounds are set at the start of the season the dateEnd will be the date of the 33rd round, not the end of the season. Same goes for cup tournaments that don't have a placeholder match for the final.
stageTypeId Enum(Int) data:
1 League
2 Cup
3 Open
4 League with penalties when a draw
5 Not set. This is a placeholder value
tournament TournamentCompact  
data Array data:
ratings Bool
assists Bool
indirectAssists Bool - See indirect assist for more info.
attendances Bool
corners Bool
goalscorers Bool
halfTimeScore Bool
minutesPlayed Bool
penalties Bool
redCards Bool
referees Bool
shots Bool
yellowCards Bool
transfers Bool
visibilityId Enum(Int) possible values:
1 Show for all
2 Show only on nifs.no
3 Show for some customers and on nifs.no - Not in use
4 Show for some customers but not on nifs.no - Not in use
5 Do not show
comment String or null  
teams TeamCompact[] Optional. See teams for more info.
names Name[] Optional. See names for more info.
externalIds string[] Optional. Might contain external ids from NFF, Enetpulse or TV 2.
numberOfRounds Int Optional. This is the number of round for which there will be in the stage. 30 in Eliteserien, 38 in Premier League, 9 in the FA Cup etc.
maxRoundNumber Int Optional. This is the current maximum round number on a match in the stage. It might not be equal to numberOfRounds as some matches might be missing. Typically only one half of a league is scheduled or for a cup which haven't ended the final rounds are missing.

Data returned:

Teams

Methods:
GET, OPTION

Query parameters:
Url Possible values Description
stages/{$stagetId}/teams/   List all teams in a stages. Linked example is Tippeligaen 2015
countries/{$countryId}/teams/?gender= 'men', 'women' or null. Gender is optional. List all teams in a country. Linked example is Norwegian womens teams. For Norway teams of lower age classes are filtered out.
teams/{$teamId}/   A team. Linked example is Brann
teams/?search={$term} A string with at least two characters. Search for team. Linked example is search for "Brann"
teams/?inCustomerStages=1 List all teams that has participated in a stage chosen by at least one customer
teams/{$teamId}/stages/   List all stages a team has participated in. Linked example is Brann
teams/{$teamId}/stages/?active=1   List all active stages a team is participating in this season. Linked example is Brann
stages/{$stageId}/teams/playerTransfers/?includeLoans=1&includeFutureTransfers=1 List all teams in a stages with transfers in the most recent transfer window. Linked example is German Bundesliga 2016/17.

Data for Team modus:
Name Type Description
type String Value = "nifs:team" or "nifs:teamCompact" in compact mode
id Int  
uid String prefix = "te" or "te_c" in compact mode
name String  
country CountryCompact  
homePage Url  
address String or null Visitor address, not necessarily post address
clubTeam Bool false if it is a national team
gender string "men" or "women"
attendanceRecord Int or null  
dateFounded String If month or date are unknown they are still set as "00", alas a team founded in 1992, but on unknown date will return "1992-00-00".
comment String or null  
city Place or null Current home city. See places for more information.
placeHolder Bool Set to true if the team is a placeholder like '1A/3ABC', "Everton/Manchester City" or "Winner semifinal 1". If this is true a client should not be able to see this teams profile
logo Image or null See image for more information.
teamPhoto Image or null See image for more information.
stadiums Stadium[] or null Sorted so that first stadium in list is current stadium. Teams utilizing more than one stadium is not supported at the moment. See stadiums for more info.
names Name[] or null See names for more info
kits Kit[] or null See kit for more information
honours Honour[] or null See honour for more information
players Person[] or null Players currently in squad. See persons for more information.
staff Person[] or null Non playing persons currently in team. See persons for more information.
isYouthTeam Bool Set to true if team is a youth team.

Data returned:

Data for Team in table modus:
Name Type Description
type String Value = "nifs:team" or "nifs:teamCompact" in compact mode
id Int  
uid String prefix = "tit" or "tit_c" in compact mode
name String  
shortName String Optional. Max 15 characters.
country CountryCompact  
place Int Two or more team can have the same place if they are 100% equally placed. The teams are then sorted by name. The JSON is sorted in the API and should not be sorted anew on the client side.
played Int The data is live so data from ongoing matches are also added to played, won, draw, etc.
won Int  
drawWonPenalties Int Optional. Only set when it is a league with penalties after drawn matches.
wonPenalties Int Optional. Only used in ice hockey. Matches won after penalties
wonOvertime Int Optional. Only used in ice hockey. Matches won after sudden death
draw Int  
lost Int  
lostPenalties Int Optional. Only used in ice hockey. Matches lost after penalties
lostOvertime Int Optional. Only used in ice hockey. Matches lost after sudden death
goalsScored Int  
goalsConceded Int  
goalDifference Int  
points Int  
lastSixMatches Int or String Format: "1,2,2,1,3,1" Where:
1 Won
2 Lost
3 Draw
If there is only one match the value will be an Int.
changeSinceLastRound Int
logo Image Optional. See image for more info.
names Name[] or null Optional. See names for more info

Data for Team in match modus:
Name Type Description
type String Value = "nifs:team"
id Int  
uid String prefix = "tim"
name String Team name - This is the name use by this team in this stage. As an example would Germany be named 'Vest Tyskland' in a match in FIFA World Cup 1990, but 'Tyskland' in World Cup 1994
shortName String Optional. Short version (max 15 characters) of the teams name in this stage.
persons Person[] Lineup for team in match, not squad. See Persons for more info.
captain PersonCompact or null
result Enum(Int) or null possible values:
null Result not set
1 Won
2 Lost
3 Draw
resultTypeId Enum(Int) or null possible values:
null Result not set
1 After 90 minutes
2 After extra time
3 On penalties after extra time
4 On golden goal
5 On silver goal
6 On penalties without extra time
kit Kit or null not implemented yet
logo Image or null See image for more info.
matchStatistics TeamInMatchStatistics or null See TeamInMatchStatistics for more info.
formation string Optional. Only set if 11 players are set on the team and it is a valid formation (3-4-3, 3-5-2, 4-2-4, 4-3-3, 4-4-2, 5-3-2, 5-4-1, 4-5-1, 3-2-4-1, 4-1-4-1, 4-1-3-2, 4-2-3-1, 4-4-1-1, 4-3-2-1).

Data for Person in team modus:
Name Type Description
type String Value = "nifs:team"
id Int  
uid String prefix = "pit"
name String  
fromDate Date or null Format 'yyyy-mm-dd' where 'dd' and 'mm-dd' are "00" and "00-00" respectively if they are unknown
toDate Date or null Format 'yyyy-mm-dd' where 'dd' and 'mm-dd' are "00" and "00-00" respectively if they are unknown
active Bool  
employmentId Enum(Int) possible values:
Id English Norwegian
1 Player Spiller
2 Main coach Hovedtrener
3 Manager Manager
4 Assistant coach Assistenttrener
5 Assistant manager Assisterende manager
6 Goalkeeping coach Keepertrener
7 Youth coach Ungdomstrener
8 Talent coach Talentutvikler
9 Development coach Spillerutvikler
10 Sporting director/Director of football Sportslig leder/direktør
11 Managing director Daglig leder/direktør
12 Board chairman Styreformann
13 Medical doctor Lege
14 Stadium manager Anleggssjef
15 Groundskeeper Banemester
16 Team coordinator Oppmann
17 Kit manager Materialforvalter
18 Physio Fysioterapeut
19 Marketing director Markedsansvarlig
20 Referee Dommer
21 Unknown Ukjent
22 Assistant sporting director Assisterende sportslig leder
23 Physics coach Fysisk trener
24 Medical staff Medisinsk ansvarlig
25 Scout Speider
26 Sports administrator Sportslig administrator
27 Development director Utviklingsansvarlig
28 Sports coordinator Sportslig koordinator
29 Match analysts Analysesjef
30 Football director Toppfotballsjef
31 Other administrative staff Annen administrativ stilling
32 Mental coach Mental trener
33 Operational leader/Strategic controller Operativ leder/Strategisk controller
34 Sports consultant Sportslig konsulent
35 Board member Styremedlem
36 President President
37 Owner Eier
38 Salesman Selger
39 Recruitment director Rekruteringsansvarlig
40 Technical director Teknisk direktør
41 Sports adviser Sportslig rådgiver
contractTypeId Enum(Int) or null possible values:
null Standard contract
2 On loan
3 Trial
6 Rolling
8 Loaned out
9 Caretaker
10 Trainee
11 Guest
shirtNumber Int or null  
position Position See Positions for more info
clubTeam Bool False if it is a national team like Norge or Spania U21
logo Image Optional. Only set if 'withTeamLogos=1' is in a persons query. See image for more info
isYouthTeam Bool Optional. Set to true if team is a youth team.

Data for head to head modus:
Name Type Description
type String Value = "nifs:team"
id Int  
uid String prefix = "th2h"
name String  
shortName String Optional
wonHome Int Optional. Only set on first team. Head to head home matches won by the first team. Friendlies and other non competitive matches are excluded.
drawnHome Int Optional. Only set on first team. Head to head home matches drawn by the first team. Friendlies and other non competitive matches are excluded.
lostHome Int Optional. Only set on first team. Head to head home matches lost by the first team. Friendlies and other non competitive matches are excluded.
goalsForHome Int Optional. Only set on first team. Head to head goals scored at home by the first team. Friendlies and other non competitive matches are excluded.
goalsAgainstHome Int Optional. Only set on first team. Head to head goals conceded at home by the first team. Friendlies and other non competitive matches are excluded.
wonAway Int Optional. Only set on first team. Head to head away matches won by the first team. Friendlies and other non competitive matches are excluded.
drawnAway Int Optional. Only set on first team. Head to head away matches drawn by the first team. Friendlies and other non competitive matches are excluded.
lostAway Int Optional. Only set on first team. Head to head away matches lost by the first team. Friendlies and other non competitive matches are excluded.
goalsForAway Int Optional. Only set on first team. Head to head goals scored away by the first team. Friendlies and other non competitive matches are excluded.
goalsAgainstAway Int Optional. Only set on first team. Head to head goals conceded away by the first team. Friendlies and other non competitive matches are excluded.
wonHomeForm Int Number of victories from the team's last six home matches. Friendlies and other non competitive matches are excluded.
drawnHomeForm Int Number of draws from the team's last six home matches. Friendlies and other non competitive matches are excluded.
lostHomeForm Int Number of losses from the team's last six home matches. Friendlies and other non competitive matches are excluded.
goalsForHomeForm Int Number of goals scored from the team's last six home matches. Friendlies and other non competitive matches are excluded.
goalsAgainstHomeForm Int Number of goals conceded from the team's last six home matches. Friendlies and other non competitive matches are excluded.
wonAwayForm Int Number of victories from the team's last six away matches. Friendlies and other non competitive matches are excluded.
drawnAwayForm Int Number of draws from the team's last six away matches. Friendlies and other non competitive matches are excluded.
lostAwayForm Int Number of losses from the team's last six away matches. Friendlies and other non competitive matches are excluded.
goalsForAwayForm Int Number of goals scored from the team's last six away matches. Friendlies and other non competitive matches are excluded.
goalsAgainstAwayForm Int Number of goals conceded from the team's last six away matches. Friendlies and other non competitive matches are excluded.


TeamInMatchMatchStatistics

Data:
type String Value = "nifs:teamInMatchStatistics"
uid String prefix = "timStat"
shotsOnGoal Integer Optional
totalShots Integer Optional
possession Integer Optional
postHits Integer Optional - Number of shots hitting the posts or the bar
saves Integer Optional
chances Integer Optional
offsides Integer Optional
crosses Integer Optional
shotsOffTarget Integer Optional
blockedShots Integer Optional
corners Integer Optional
goalKicks Integer Optional
freeKicks Integer Optional
throwIns Integer Optional
yellowCards Integer Optional
redCards Integer Optional
treatments Integer Optional

Kit

Data:
Name Type Description
type String Value = "nifs:kit"
id Int  
uid String prefix = "kit"
colorCodes Array[String]  
kitTypeId Int possible values:
1 First kit
2 Away kit
3 Third kit
4 Keeper kit
5 Keeper away kit
6 International kit (for example for european cups)
7 Away kit reserve
8 First kit reserve
patternId Int possible values:
1 Monochrome
2 Horizontal stripes
3 Vertical stripes
4 Two colors split with separate sleeve
5 Squares
6 Two colors split
7 Monochrome with colored sleeves
numberColor String Optional. Should be white if not set


Honour

Data:
Name Type Description
type String Value = "nifs:honour"
id Int  
uid String prefix = "h"
name String Name of stage won
honourTypeId Int possible values:
1 Winner
2 Second
3 Third
tournament TournamentCompact See tournaments for more info.
year String Possible styles: '2003' and '2003/2004'
title String Optional. Example: "Europamester" for EM
number Int Optional. Brann's cup gold in 2004 was their number 6. This value can be used when not all achievements are set for a tournament
stageId Int or null Only set if the achievement is connected to an existing stage


Stadium

Methods:
GET, OPTION

Query parameters:
Url Possible values Description

Data:
Name Type Description
type String Value = "nifs:stadium" or "nifs:stadiumCompact" in compact mode
id Int  
uid String prefix = "s" or "s_c" in compact mode
name String  

Data for Team at stadium modus:
Name Type Description
type String Value = "nifs:stadium" or "nifs:stadiumCompact" in compact mode
id Int  
uid String prefix = "s" or "s_c" in compact mode
name String  
dateFrom String or null At the moment month and day is not known but are still present as "00"
dateTo String or null At the moment month and day is not known but are still present as "00". null means that either the date is unknown or the team is using the stadium.

Persons

Methods:
GET, OPTION

Query parameters:
Url Description
persons/{$personId} Person profile. Linked example is Håkon Opdal. Include are:
  • Logos for the person's teams.
  • Stage statistics (per team) for person, but without friendlies.
  • Youth teams are merged if they are in the same club. For example would Odda G16 and Odda Junior be merged.
persons/?officials=1 List all officials (referees)
persons/?officials=1&excludeStageId={$stageId} List all officials (referees) excluding those who already are connected to $stageId. Linked example is all except those connected to Tippeligaen 2015.
teams/{$teamId}/persons/?withLastMatchAndMatchEventDate=1 List all active persons (both players and staff) in team. Include last match date and last match event date

Data for Person modus:
Name Type Description
type String Value = "nifs:person" or "nifs:personCompact" in compact mode
id Int  
uid String prefix = "p" or "p_c" in compact mode
name String The common name of the person like 'Håkon Opdal', 'Neymar', 'Drillo' or 'Jón Dadi Bödvarsson'
firstName String or null  
lastName String or null  
nickName String or null For brazilian type nick names. Other nicknames are found under 'names'
shirtName string Nickname (Pelé) if person has one. If not last name.
names Name[] or null See names for more info
position Position See positions for more info
birthDate Date or null Format 'yyyy-mm-dd' where 'dd' and 'mm-dd' are "00" and "00-00" respectively if they are unknown. Alas a person born in 1992, but on unknown date will return "1992-00-00".
country CountryCompact or null This is the country for which the player would play for the national team, alas for Pepe this is Portugal
country2 CountryCompact or null Optional. Only available for footballers. This is used only for persons with two nationalities, alas for Pepe this is Brazil
gender Enum(String) possible values: "men", "women". (Plural form due to consistency with tournaments)
homePage Url Optional
height Int or null We do not have weight in the database
isAReferee Bool If true the person can also be a player
comment String or null
hungUpBootsDate Date Optional. Format 'yyyy-mm-dd' where 'dd' and 'mm-dd' are "00" and "00-00" respectively if they are unknown.
deathDate Date Optional. Format 'yyyy-mm-dd' where 'dd' and 'mm-dd' are "00" and "00-00" respectively if they are unknown.
birthPlace Place or null See places for more info
teams Team[] or null See teams for more info
transfers Transfer[] or null See player transfers for more info
stageStatistics StageStatistics[] See stage statistics for person for more info
profilePicture Image Optional. See image for more info.
profilePictures Image[] Optional. Only used in football. See image for more info.
kit Kit Optional. See kit for more info.

Data for Person in match modus:
Name Type Description
type String Value = "nifs:person"
id Int  
uid String prefix = "pim" or "pim_c" in compact mode
name String  
position Position or null See Positions for more info
startsMatch Boolean
startsOnTheBench Boolean Either startsMatch or startsOnBench will be true.
currentlyOnTheField Boolean Players that has been red carded has this value as false. After the match all players who was on the field when the referee blew for full time have this value as true
entersFieldMinute Int or null
leavesFieldMinute Int or null
minutesPlayed Int This value is not 100% accurate as regular halfs are always counted to have 45 minutes and extra time halfs have 15. Overtime is not counted.
shirtNumber Int or null  
personId Int
teamId Int
matchId Int
country CountryCompact or null
shirtName string Nickname (Pelé) if person has one. If not last name.
rating int Optional. Only set if the player has been rated in this match.
teamsBest int Optional. True if player is set as the teams best in the match.
manOfTheMatch bool Optional. True if player is man/woman of the match.
positionIdTeam int Optional. Set if the player have not been set to a position in the match but have a regular position (defence, midfield, attack) on the team.
profilePicture Image Optional. See image for more info.

Data for Referee in match:
Name Type Description
type String Value = "nifs:personCompact"
id Int  
uid String prefix = "pr_c"
name String  
refereeTypeId Enum(Int) possible values:
1 Referee
2 Assistant referee
4 Fourth referee
5 Goal line assistant referee
6 VAR referee
matchId Int  
personId Int  
country CountryCompact Optional. See countries for more info.
team TeamCompact Optional. Only set if the official is connected to a team as a referee. See teams for more info.
inMinute Int Optional. Set if a fourth official has taken over for the referee during the match due to an injury or other reasons.
outMinute Int Optional. Set if the referee had to leave the field due to an injury or other reasons.

Stage statistics for person

Data:
type String Value = "nifs:stageStatisticsForPerson"
id Int  
uid String prefix = "ssfp"
stage Stage See stages for more info
team TeamCompact See teams for more info
matches Int Optional. Only set if 'data[minutesPlayed]' is set on stage.
matchesStarting Int Optional. Only set if 'data[minutesPlayed]' is set on stage.
matchesStartingOnBench Int Optional. Only set if 'data[minutesPlayed]' is set on stage.
matchesComingOnFromBench Int Optional. Only set if 'data[minutesPlayed]' is set on stage.
matchesSubstituted Int Optional. Only set if 'data[minutesPlayed]' is set on stage.
minutes Int Optional. Only set if 'data[minutesPlayed]' is set on stage.
goals Int Optional. Only set if 'data[goalscorers]' is set on stage.
ownGoals Int Optional. Only set if 'data[goalscorers]' is set on stage.
assists Int Optional. Only set if 'data[assists]' is set on stage.
indirectAssists Int Optional. Only set if 'data[indirectAssists]' is set on stage.
yellowCards Int Optional. Only set if 'data[yellowCards]' is set on stage.
redCards Int Optional. Only set if 'data[redCards]' is set on stage.
matchesWon Int Optional. Only set if 'data[minutesPlayed]' is set on stage.
matchesDrawn Int Optional. Only set if 'data[minutesPlayed]' is set on stage.
matchesLost Int Optional. Only set if 'data[minutesPlayed]' is set on stage.

Matches

Methods:
GET, OPTION

Query parameters:
Url Description Live
matches/{$matchId}/ One specific match. Linked example is England-Italy from Euro 2012. This feed is live yes
matches/?fiksId={$FIKSid} One specific match with FIKS/NFF-id. Linked example is Strømsgodset-Ranheim in Eliteserien 2018 yes
matches/?fiksMatchNumber={$FIKSmatchNumber} One specific match with FIKS/NFF match number. Linked example is Strømsgodset-Ranheim in Eliteserien 2018 yes
matches/{$matchId}/?summary=1 One specific match. Linked example is England-Italy from Euro 2012. Only show match fact match events. no
stages/{$stagesId}/matches/ List all matches for one specific stage. Linked example is Tippeligaen 2015. yes
stages/{$stagesId}/matches/?date=YYYY-mm-dd List all matches for one specific stage on a date. Linked example is Tippeligaen 2015. no
stages/{$stagesId}/matches/?getAllInChampionship=1 List all matches for the championships the stage is part of. Linked example is Champions League 2018/19 from the "Sluttspill" stage. no
stages/{$stagesId}/matches/?getActiveRound=1 List all matches in the active "round" for a stage. A "round" is typically from friday to monday or from tuesday to thursday. This means that a midweek "round" where several matches that was postponed earlier can consist of matches with different round number. Linked example is Tippeligaen 2016 which will return round 30 from 2016-11-03.  
stages/{$stagesId}/matches/?getActiveRound=1&getNextRound Like the stages/{$stagesId}/matches/?getActiveRound=1 but it will force the return of two rounds if possible. Alas there will allways be a future round if there are future matches. If there are no future matches, then an empty list will be returned.  
stages/{$stagesId}/matches/?round=6 List all matches in a round for a stage. Linked example is Tippeligaen 2016 round 6.  
stages/{$stagesId}/matches/?full=1 List all matches for one specific stage with extended info. Linked example is Tippeligaen 2015.  
matches/?date=yyyy-mm-dd List all matches for one specific date. Linked example is 2015-10-01.  
matches/?date=yyyy-mm-dd&inCustomerStages=1 List all matches in stages selected by at least on customer on one specific date. Linked example is 2015-10-01.  
stages/{$stagesId}/matches/?teamId={$teamId} List all matches for one specific stage for a team. Linked example is Brann in Tippeligaen 2014.  
stages/{$stagesId}/matches/?maxDate={$date} List all matches for one specific stage up until (and including) max date. Linked example is Brann Eliteserien 2017 matches before and including 6th of july. no
matches/?matchId={$matchId1},{$matchId2},{$matchId3},etc List all matches with specified ids. Linked example is some matches from Tippeligaen 2001.  
matches/{$matchId}/headtohead/ Head to head statisics for teams involved in match. See head to head for more info. Linked example is England-Italy  
matches/?updatedSince=yyyy-mm-dd hh:ii:ss Get all (played or abandoned) updated matches today or yesterday that has been updated since updatedSince. A match will be listed if an event or player in the match has been updated too.  
matches/?updatedSince=yyyy-mm-dd hh:ii:ss&includeAllChangedMatches=1 Get all updated matches since. No limits, so don't use an old timestamp!  

Data:
Name Type Description
type String Value = "nifs:match" or "nifs:matchCompact" in compact mode
id Int  
uid String prefix = "m" or "m_c" in compact mode
name String  
timestamp Date ISO 8601
matchStatusId Enum(Int) possible values:
1 Played
2 Not started (Also "result unknown")
3 Postponed
4 Abandoned
5 Will not be played
6 Date not set
7 Ongoing
8 First half
9 Half time
10 Second half
11 First half extra time
12 Second half extra time
13 Penalty shootout
14 Pause before extra time
15 Half time extra time
16 Played, but cancelled
17 Played, but not counting in statistics
18 Second half time extra time
19 Third half extra time
20 Third half time extra time
21 Fourth half extra time
22 Third half
23 Fourth half time extra time
24 Fifth half extra time
25 Fifth half time extra time
26 Sixth half extra time
27 Sixth half time extra time
28 Seventh half extra time
29 Seventh half time extra time
30 Eighth half extra time
31 Second half time
matchLength Enum(String) possible values:
2*45 Default
2*40 Used in youth football
2*35 Used in youth football
2*30 Used in youth football
2*25 Used in youth football
2*20 Used in youth football
2*15 Used in youth football
3*30 Sometimes used in friendly matches
1*40 Used in youth football
1*30 Used in youth football
matchTypeId Enum(Int) or null possible values:
null Regular match. Use round instead
1 Final
2 Bronze final
3 Semi final
4 Quarter final
5 1/8 final
6 5. place play off
7 Minor semi final
8 Major semi final
9 Preliminary final
10 Elimination final
11 7th place play off
12 9th place play off
13 11th place play off
14 Elimination Semi-Final
15 Preliminary Semi-Final
16 Qualifying final
17 Play off match
18 13th place play off
19 15th place play off
20 17th place play off
21 19th place play off
22 Knockout round
23 Conference semifinal
24 Conference final
25 1/16 final
26 21th place play off
27 23th place play off
28 Conference quarter final
29 Play off
round Int or null round is only set if it is known. When matchTypeId is set, use that instead
attendance Int or null  
result Result See Results for more info
stadium Stadium or null See Stadium for more info
homeTeam TeamCompact with Person[] See Teams for more info
awayTeam TeamCompact with Person[] See Teams for more info
stage Stage See Stages for more info
stageId Int
referees Referee[] This attribute is only set if the match have referee(s). See Referee for more info
matchEvents MatchEvent[] This attribute is only set if the match have match event(s). See MatchEvents for more info
liveFeeds LiveFeeds[] or null See Live feed for more info
comment String or null  
tv2Ids Int[] Optional. Only set when ?full=1 is set
externalIds Array Optional. List of external ids like TV2, Enetpulse, Fiks/NFF, NIF etc.
isLineupConfirmed bool Optional. If false, lineup should not be shown even if there are players in the lineup
coveredLive bool If false, match should not be shown in a live match list. It can be shown, but not selectable in a fixture list. All played matches always have this set to true
matchRelation MatchRelation Optional. See MatchRelation for more info. Only set if the match has a relation and this is the latest match in that relation and the first match is played
matchStatistics MatchStatistics Deprecated! Use homeTeam.matchStatistics and awayTeam.matchStatistics instead. Optional. See MatchStatistics for more info.
timeStartFirstHalf Date Optional. ISO 8601. Only set if match is ongoing, is in first half and second half has not started.
timeStartSecondHalf Date Optional. ISO 8601. Only set if match is ongoing, is in second half and extra time has not started.
timeStartFirstHalfExtraTime Date Optional. ISO 8601. Only set if match is ongoing, is in first half extra time and second half extra time has not started.
timeStartSecondHalfExtraTime Date Optional. ISO 8601. Only set if match is ongoing and second half extra time has started.
matchStreams MatchStream[] Optional. Only set if there is a stream for this match. See MatchStream for more info.
matchHighlightsVideo Video Optional. Only set if there is a match highlight video for this match. See Video for more info.
tvChannels TVChannel[] Optional. Only set if there are tv channels showing the match. See TV Channel for more info.
lastUpdated Date Optional. ISO 8601. Only set if the match, a team in the match, a match event or a lineup has changed
municipality Municipality or null Optional. Municipality of home team (Norway only). See Municipality for more info

Data returned:

Results

Data:
Name Type Description
type String Value = "nifs:result"
uid String prefix = "res"
homeScore45 Int or null Optional. Only set if the match has reached half-time.
homeScore90 Int or null  
homeScore105 Int This attribute is only available if the match went to extra time
homeScore120 Int This attribute is only available if the match went to extra time
homeScorePenalties Int This attribute is only available if the match went to penalties
awayScore45 Int or null Optional. Only set if the match has reached half-time.
awayScore90 Int or null  
awayScore105 Int This attribute is only available if the match went to extra time
awayScore120 Int This attribute is only available if the match went to extra time
awayScorePenalties Int This attribute is only available if the match went to penalties
scorePeriod1 String Optional. Only set for ice hockey matches, and only those with match events.
scorePeriod2 String Optional. Only set for ice hockey matches, and only those with match events.
scorePeriod3 String Optional. Only set for ice hockey matches, and only those with match events.
scoreSuddenDeath String Optional. Only set for ice hockey matches, and only those who went to sudden death.

Live feed

Data:
Name Type Description
type String Value = "nifs:liveFeed"
uid String prefix = "lf"
id Integer
customerId Integer or null
matchId Integer
prioritized Boolean
ended Boolean If the live feed is ended the match events should be sorted from start to end. If it is not ended, then the newest (end to start) should be sorted first.
user NifsUser or null See NifsUser for more info.

MatchStatistics

Data:
Name Type Description
type String Value = "nifs:matchStatistics"
uid String prefix = "mStat"
shotsOnGoalHomeTeam Integer Optional
shotsOnGoalAwayTeam Integer Optional
totalShotsHomeTeam Integer Optional
totalShotsAwayTeam Integer Optional
possessionHomeTeam Integer Optional
possessionAwayTeam Integer Optional
offsidesHomeTeam Integer Optional
offsidesAwayTeam Integer Optional
crossesHomeTeam Integer Optional
crossesAwayTeam Integer Optional
shotsOffTargetHomeTeam Integer Optional
shotsOffTargetAwayTeam Integer Optional
blockedShotsHomeTeam Integer Optional
blockedShotsAwayTeam Integer Optional
cornersHomeTeam Integer Optional
cornersAwayTeam Integer Optional
goalKicksHomeTeam Integer Optional
goalKicksAwayTeam Integer Optional
freeKicksHomeTeam Integer Optional
freeKicksAwayTeam Integer Optional
throwInsHomeTeam Integer Optional
throwInsAwayTeam Integer Optional

MatchEvents

Methods:
GET, OPTION, POST, PUT, DELETE

Query parameters:
Url Possible values Description
matchEvents/?latest=1   List latest important events from matches that are covered by at least one customer group.

Data:
Name Type Description
type String Value = "nifs:matchEvent"
id Int  
uid String prefix = "me"
comment String or null  
matchEventTypeId Enum(Int) data:
Id Type Sports
1 Comment All
2 Goal All
3 Red card All
4 Yellow card All
5 Assist - Always have the same 'sorting' as a goal event Football, ice hockey
6 Offside Football, ice hockey
8 Own goal - Own goals are not connected to the team that conceded the goal although the player is on the conceding team. All
9 Penalty All
10 Penalty goal - May have the same 'sorting' as a penalty event All
11 Penalty miss - May have the same 'sorting' as a penalty event All
12 Second yellow card Football
13 Disallowed goal All
14 Match kicks off All
15 Half time All
16 Match ends All
17 Second half ends and extra time will be played (could also go directly to penalties). Either 16 or 17 are used in a match, not both Football, handball
18 Half time extra time All
19 Penalties shootout All
20 End second half extra time All
23 Player substituted Football
24 Substitute on - Always have the same 'sorting' as a "Player substituted" event Football
25 Corner Football
26 Start second half All
27 Corner goal - May have the same 'sorting' as a corner event Football
28 Start first half extra time All
29 Start second half extra time All
30 Goal penalties shootout - May have the same 'sorting' as a "Penalty penalties shootout" event All
31 Miss penalties shootout - May have the same 'sorting' as a "Penalty penalties shootout" event All
32 Penalty penalties shootout All
41 Free kick Football
43 Lineup ready Football
44 Withdrawn red card Football
45 Withdrawn yellow card Football
46 Withdrawn second yellow card Football
47 Second yellow card changed to first yellow card (The first yellow card has been withdrawn) Football
48 Indirect assist Football
49 TV 2 video event Football
100 Two minutes suspension Handball, ice hockey
101 Five minutes suspension Ice hockey
102 Ten minutes suspension Ice hockey
103 Two minutes suspension and penalty Ice hockey
104 Second half time extra time Handball, ice hockey
105 Start third half extra time Handball, ice hockey
106 Third half time extra time Handball, ice hockey
107 Start fourth half time extra time Handball, ice hockey
108 Shot Handball, ice hockey
109 Face off Ice hockey
110 Second half time Ice hockey
111 Start third half Ice hockey
112 Blue card Handball
113 Match penalty - 25 minutes Ice hockey
114 Fourth half time extra time Ice hockey
115 Start fifth half time extra time Ice hockey
116 Fifth half time extra time Ice hockey
117 Start sixth half time extra time Ice hockey
118 Sixth half time extra time Ice hockey
119 Start seventh half time extra time Ice hockey
120 Seventh half time extra time Ice hockey
121 Start eighth half time extra time Ice hockey
123 VAR All
124 Offence All
125 Fouled - Always have the same 'sorting' as an offence event All
126 Injury Time - The comment will hold the number of minutes added on by the officials Football
127 Annulled penalty kick - When the penalty kick has to be retaken Football
128 Annulled penalty goal - Always have the same 'sorting' as an annulled penalty event Football
129 Annulled penalty miss - Always have the same 'sorting' as an annulled penalty event Football
130 Penalty save Always have the same 'sorting' as a penalty event, and thus the same as a penalty miss event too
131 Annulled penalty save Always have the same 'sorting' as an annulled penalty event, and thus the same as an annulled penalty miss event too
periodId Enum(Int) data:
1 Before match
2 First half
3 Half time
4 Second half
5 Pause before extra time
6 First half extra time
7 Half time extra time
8 Second half extra time
9 Pause before penalties shootout
10 Second half time (ice hockey)
11 Third half (ice hockey)
12 Second half time extra time
13 Third half extra time
14 Third half time extra time
15 Fourth half extra time
16 Fourth half time extra time
17 Fifth half extra time
18 Fifth half time extra time
19 Sixth half extra time
20 Sixth half time extra time
21 Seventh half extra time
22 Seventh half time extra time
23 Eighth half extra time
30 Penalties shootout
31 After match
periodSorting Enum(Int) Possible values: 1, 2, 3, 4, 5, 6, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 50, 51, 60
important Boolean Used by reporters to mark a comment event as important
sorting Int This is used to sort the events and show which events should be merged. For example should an assist event be merged with a goal event in a match report.
time Int or null Is only set if the event was in the match. Text events before or after match do not time set
timeRounded Int or null Optional. Is only set if the event was in the match. Text events before or after match do not have timeRounded set. This is the minute in the match. Ie. if time=0 and second=14, thus timeRounded is 1
seconds Int or null Optional. Is only set if the event was in the match.
overtime Int or null  
overtimeRounded Int or null Optional. Is only set if the event was in the match. Text events before or after match do not have overtimeRounded set. This is the minute in the match. Ie. if overtime=0 and second=14, thus overtimeRounded is 1
team TeamCompact Own goals are connected to the team that concedes the goal. See Teams for more info
person PersonCompact See Persons for more info
matchId Int  
liveFeedId Int or null  
match MatchCompact Optional. See Matches for more info
score String Optional. Score after the event. If it is the first goal in the match the score is 1-0 or 0-1.
videos Video[] Optional. Only set if there is a video for this event. See Video for more info.


Match relation

Methods:
GET


Data:
Name Type Description
type String Value = "nifs:matchRelation"
id Int  
uid String prefix = "mr"
winningTeamId Int or null (very rare in football, but common in other sports where best of > 2 matches is common, like in ice hockey)
victoryTypeId Enum(Int) or null (very rare in football, but common in other sports where best of > 2 matches is common, like in ice hockey) possible values:
null Not yet set or there was no winner of the tie. Example: Second match in the final of Copa América 1979
1 Aggregated
2 On away goals rule
3 After penalties
4 Aggregated after extra time
5 On away goals rule after extra time
8 After replay
9 Due to best position in league
10 Walkover
matchRelationTypeId Enum(Int) possible values:
1 Replay
2 Two legged tie
3 Two legged tie in a league. Only used in Switzerland's Challenge League 2004.
otherMatchId Int Optional. Only used in match relations with two matches (football, handball)
otherMatch Match Optional. Only used in match relations with two football matches
score String Optional. Set in match relations with more than two matches (ice hockey)
playedMatches Int Optional. Set in match relations with more than two matches (ice hockey)
totalMatches Int Optional. Set in match relations with more than two matches (ice hockey)
aggregatedHomeMål Int Optional. Not set when the match relation is a replay.
aggregatedAwayGoals Int Optional. Not set when the match relation is a replay.
aggregatedHomeGoalsExtraTime Int Optional. Neither set when the match relation is a replay nor if the match did not go to extra time.
aggregatedAwayGoalsExtraTime Int Optional. Neither set when the match relation is a replay nor if the match did not go to extra time.
matchNumber Int (1 or 2) Optional. Only set for football. Shows if a match is the first or last of a relationship. v3 API only.

Data returned:

Video

Data:
Name Type Description
type String Value = "nifs:video"
id Int  
uid String prefix = "v"
source Enum(String) Available options: Lemonwhale, TV 2, NRK.
lemonwhaleId String Use this id to get video from Lemonwhale's API.
assetId Int Use this id to get video from TV 2.
url String Url to video clip. Used for NRK.
imageURL String Url to preview image.
customerConcernId Ing

Head to head

Methods:
GET, OPTION

Query parameters:
Url Description
matches/{$matchId}/headtohead/ Head to head statistics for teams involved in match. Only matches from same tournament is included. Linked example is England-Italy.
matches/{$matchId}/headtohead/?includeOtherTournaments=1 Head to head statistics for teams involved in match. All matches except friendlies are included. Linked example is England-Italy.

Data:
Name Type Description
type String Value = "nifs:headtohead"
id Int Non unique
uid String prefix = "h2h"
teams Team[] See Teams for more info.
previousMatches MatchCompact[] See Matches for more info. Only competitive matches in this tournament. Friendlies are excluded.
previousMatchesOtherTournaments MatchCompact[] See Matches for more info. Only competitive matches in tournaments other than the requesting match. Friendlies are excluded.
previousMatchesFriendlies MatchCompact[] See Matches for more info. Friendlies and other non competitive matches.
tournamentName string  
fromSeason string We have statistics from this season (year) and forward.

Table

Methods:
GET, OPTION

Query parameters:
Url Possible values Description
tournaments/{$tournamentId}/stages/{$stageId}/table/
or
stages/{$stagesId}/table/
  Live table for a stage. Linked example is Tippeligaen 2015.
stages/{$stagesId}/table/?static=1   Static table for a stage. Linked example is Tippeligaen 2015.
stages/{$stagesId}/table/?fromDate={$fromDate}&toDate={$toDate}   Table from a date to a date
stages/{$stagesId}/table/?fromRound={$fromRound}&toRound={$toRound}   Table from a round to a round

Data:
Name Type Description
type String Value = "nifs:table"
id Int  
uid String prefix = "ta"
tableType String Only 'Full time' is implemented so far
stage Stage See Stages for more info.
tableDividingLines TableDividingLine[] See Table Dividing Line for more info.
tableSortingRules TableSortingRule[] or null See Table Sorting Rule for more info.
teams Team[] or null See Teams for more info.
splitPlace int Optional. Only set if the table is split like the Scottish Premier League is
splitRound int Optional. Only set if the table is split like the Scottish Premier League is
lastUpdated string or null Date string in CET holding the last updated time of the table

Data returned:

Table Dividing Line

Data:
Name Type Description
type String Value = "nifs:tableDividingLine"
id Int  
uid String prefix = "tadl"
fromPlace Int Example: Play off for The Championship in England has fromPlace=3 and toPlace=6
toPlace Int Example: Play off for The Championship in England has fromPlace=3 and toPlace=6
typeId Enum(Int) possible values:
1 Promotion
2 Relegation
3 Play off for promotion
4 Play off for relegation
5 International Cup (UEFA Champions League, Copa Libertadores etc)
6 International Cup 2 (UEFA Europa League, Copa Sudamericana etc)

Table Sorting Rule

Data:
Name Type Description
type String Value = "nifs:tableSortingRule"
id Int  
uid String prefix = "tsr"
sort Int
text String English text (en-GB)
norwegianText String Norwegian text (nb-NO)
newNorwegianText String New Norwegian text (nn-NO)
ruleId Enum(Int) data:
Rule id Rule
1 Goal difference
2 Head to head points (when the stages is finished)
3 Number of matches won
4 Goals scored
16 Head to head away goals (when the stages is finished)
17 Head to head goal difference (when the stages is finished)
18 Head to head number of matches won (when the stages is finished)
19 Head to head goals scored (when the stages is finished)
20 Away goals scored
21 Head to head points recursive (when the stages is finished)
22 Goal difference away
30 Head to head with away goals recursive (when the stages is finished)
31 Head to head points (while the stage is ongoing)
32 Head to head away goals (while the stage is ongoing)
33 Head to head goal difference (while the stage is ongoing)
34 Head to head number of matches won (while the stage is ongoing)
35 Head to head goals scored (while the stage is ongoing)
36 Head to head points recursive (while the stage is ongoing)
37 Head to head with away goals recursive (while the stage is ongoing)
40 Average points


Customer stages

Methods:
GET, OPTION, PUT

Query parameters:
Url Possible values Description
customers/{$customerId}/stages   List all stages that this customer should display. Linked example is Firda
customers/stages?active=1   List all stages that is currently displayed by a customer.

Data:
Name Type Description
type String Value = "nifs:customerStage"
id Int  
uid String prefix = "cus"
priority Int  
active Boolean
stage Stage[] Optional for PUT. See stages for more info.

Data returned:

NifsUser

Methods:
GET, OPTION

Data:
Name Type Description
type String Value = "nifs:user"
id Int  
uid String prefix = "u"
name String  
twitterHandle String or null  
phoneNumber String or null Only available for admins

Names

Data:
Name Type Description
type String Value = "nifs:name"
id Int  
uid String prefix = "np" for persons
name String  
use String Norwegian description of name
useId Enum(Int) data:
1 Name
2 Nick name - For both norwegian style and brazilian style nicknames
3 Short name
4 Full name
6 Sponsor name
9 Former name
10 Other name
11 Official name
12 Real name - In the person's/team's native alphabet
14 Wrong name - For example common misspellings
18 Sponsor free name - 'Eliteserien' for Tippeligaen
19 UEFA name - Used by UEFA on Stadiums with sponsorship names
20 FIFA name - Used by FIFA on stadiums with sponsorship names
21 Team name for referee
23 Amedia name - To be used on Amedia sites only.
24 Live name - To be used on NTB's live center.
25 Code replacement team code.
26 TV 2 first name
27 TV 2 last name
28 TV 2 nick name
29 TV 2 short name
30 TV 2 abbreviation
31 Three letter abbreviation
dateStart Date or null Format 'yyyy-mm-dd' where 'dd' and 'mm-dd' are optional if they are unknown
dateEnd Date or null Format 'yyyy-mm-dd' where 'dd' and 'mm-dd' are optional if they are unknown

Places

Methods:
GET, OPTION

Data:
Name Type Description
type String Value = "nifs:place"
id Int  
uid String prefix = "pl" for persons
name String  
country CountryCompact See countries for more info

Positions

Data:
Name Type Description
type String Value = "nifs:position"
id Int  
uid String prefix = "pos"
x Int or null X-position in a 7*7 coordinates system
y Int or null Y-position in a 7*7 coordinates system
position String Posible values:
Id English Norwegian Sports Football X coordinate Football Y coordinate
1 Keeper Keeper All   1
2 Defender Forsvar Football, Ice hockey   3
3 Right full back Høyreback Football, Handball 1 3
3 Right back   Handball    
4 Left full back Venstreback Football 7 3
4 Left back   Handball
5 Center half Midtforsvar Football 4 3
5 Center back   Handball
6 Midfield Midtbane Football   5
7 Right midfield Høyre midtbane Football 1 5
8 Left midfield Venstre midtbane Football 7 5
9 Central midfield Sentral midtbane Football 4 5
9 Center   Ice hockey
10 Striker Spiss Football 4 7
11 Unknown Ukjent All
12 Not a player Ikke spiller All
13 Forward Angrep Football   7
13 Line player   Handball
13 Attacker   Ice hockey
14 Full back Back Football   3
15 Wing Ving Football, Handball   7
16 Sweeper Sweeper Football 4 2
17 Right defensive midfield Høyre defensiv midtbane Football 1 4
18 Defensive midfield Defensiv midtbane Football 4 4
19 Left defensive midfield Venstre defensiv midtbane Football 7 4
20 Right wing Høyreving All 2 7
21 Left wing Venstreving All 6 7
22 Right offensive midfield Høyre offensiv midtbane Football 1 6
23 Offensive midfield Offensiv midtbane Football 4 6
24 Left offensive midfield Venstre offensiv midtbane Football 7 6
25 Inside right midfield Høyre indreløper Football 2 5
26 Inside left midfield Venstre indreløper Football 6 5
27 Right center half Høyre midtforsvar Football 3 3
28 Left center half Venstre midtforsvar Football 5 3
29 Right defensive central midfield Høyre deffnsiv indreløper Football 3 4
30 Left defensive central midfield Venstre defensiv indreløper Football 5 4
31 Right offensive central midfield Høyre offensiv indreløper Football 3 6
32 Left offensive central midfield Venstre offensiv indreløper Football 5 6
33 Right striker Høyre spiss Football 3 7
34 Left striker Venstre spiss Football 5 7
35 Right central midfield Høyre sentral midtbane Football 3 5
36 Left central midfield Venstre sentral midtbane Football 5 5

Player transfers

Methods:
GET, OPTION

Query parameters:
Url Description
playerTransfers/?includeLoans=1&activeStages=1&includeFutureTransfers=1 List all transfers in all active stages covered by at least one customer.

Data:
Name Type Description
type String Value = "nifs:playerTransfer"
id Int  
uid String prefix = "pt"
date Date Format 'yyyy-mm-dd' where 'dd' and 'mm-dd' are optional if they are unknown.
fromTeam TeamCompact See teams for more info.
toTeam TeamCompact See teams for more info.
person PersonCompact See persons for more info.

Image


Data:
Name Type Description
type String Value = "nifs:image"
id Int  
uid String prefix = "cus"
url String Url to image
credits String Optional
imageTypeId Int possible values:
1 Person profile (football)
2 Team photo
3 Team logo
11 Stadium image (football)
12 Tournament logo (football)
13 Person full figure - action image
14 Person half figure - action image
15 Person half figure - club team
16 Person half figure - national team
17 Person profile with shoulders
18 Person profile with cut shoulders - club team
19 Person profile with cut shoulders - national team
112 Stadium image (other sports)
113 Person profile (other sports)
114 Club logo (other sports)
115 Tournament logo (other sports)

Data returned:

Counties

Methods:
GET, OPTION

Data:
Name Type Description
type String Value = "nifs:county"
id Int  
uid String prefix = "mu"
name String  

Municipalities

Methods:
GET, OPTION

Data:
Name Type Description
type String Value = "nifs:municipality"
id Int  
uid String prefix = "mu"
name String  

Merged entity

Methods:
GET, OPTION

Query parameters:
Url Description
mergedTeams/?since=2020-11-01 00:00:00 List all merged team ids since 1st November 2020
mergedPersons/?since=2020-11-01 00:00:00 List all merged persons ids since 1st November 2020
mergedNIFTeams/?since=2020-11-01 00:00:00 List all merged nif team ids since 1st November 2020
mergedNIFPersons/?since=2020-11-01 00:00:00 List all merged nif persons ids since 1st November 2020

Data:
Name Type Description
type String nifs:mergedTeam, nifs:mergedPerson, nifs:mergedNIFTeam or nifs:mergedNIFPerson
id Int  
uid String prefix = mert, merp, mernt, mernp
timestamp Date ISO 8601
keptId Int
deletedId Int