Introduction

The NCAA Final Four API provides you with basic information from every NCAA Men’s Baksetball Tournament dating back to 1939. All responses are in JSON format.
Note: All responses include original Final Four data. Adjustments are not made for vacated appearances or championships.

Pricing Plans and Usage

Basic - This plan is suited for developers and basic website/app needs with limited usage.
Pro - More requests for a commercial app or website.
Ultra - Get access to all endpoints with up to 200 requests per day.
Mega - Enjoy unlimited requests to all endpoints. Best for enterprise usage.

Endpoints (all endpoints are GET methods)

##Final Four data by year
Year is represented by the {identifier} paramter.

/detail/{identifier} -> returns detailed Final Four data set for the given year
Sample Response

{
	"year": "1999",
	"season": "1998-1999",
	"champion": "UConn",
	"champion_nickname": "Huskies",
	"champion_coach": "Jim Calhoun",
	"champion_record": "34-2",
	"championship_score": "77-74",
	"runner_up": "Duke",
	"runner_up_nickname": "Blue Devils",
	"runner_up_coach": "Mike Krzyzewski",
	"semifinalist_1": "Michigan State",
	"semifinalist_1_nickname": "Spartans",
	"semifinalist_1_coach": "Tom Izzo",
	"semifinalist_2": "Ohio State",
	"semifinalist_2_nickname": "Buckeyes",
	"semifinalist_2_coach": "Jim O'Brien",
	"mop": "Richard Hamilton, UConn",
	"location": "St. Petersburg, FL",
	"venue": "Tropicana Field"
}

/summary/{identifier} -> returns basic Final Four data set for the given year
Sample Response

{
	"year": "1980",
	"season": "1979-1980",
	"champion": "Louisville",
	"final_four": "Louisville, UCLA, Purdue, Iowa",
	"mop": "Darrell Griffith, Louisville",
	"number_one_seeds": "Syracuse, LSU, Kentucky, DePaul"
}

/champion/{identifier} -> returns champion data for the given year
Sample Response

{
	"year": "1983",
	"season": "1982-1983",
	"champion": "NC State",
	"nickname": "Wolfpack",
	"coach": "Jim Valvano",
	"record": "26-10",
	"championship_score": "54-52",
	"seed": "6"
}

/runner-up/{identifier} -> returns runner-up data set for the given year
Sample Response

{
	"year": "1959",
	"season": "1958-1959",
	"runner_up": "West Virginia",
	"nickname": "Mountaineers",
	"coach": "Fred Schaus",
	"championship_score": "71-70"
}

/third/{identifier} -> returns third place data set for the given year (only available between 1946 and 1981)
Sample Response

{
	"year": "1970",
	"season": "1969-1970",
	"third_place": "New Mexico State",
	"nickname": "Aggies",
	"coach": "Larry Weise"
}

/fourth/{identifier} -> returns fourth place data set for the given year (only available between 1946 and 1981)
Sample Response

{
	"year": "1962",
	"season": "1961-1962",
	"fourth_place": "UCLA",
	"nickname": "Bruins",
	"coach": "John Wooden"
}

/mop/{identifier} -> returns most outstanding player for the given year
Sample Response

{
	"year": "1961",
	"season": "1960-1961",
	"mop": "Jerry Lucas, Ohio State*"
}

/seeds/{identifier} -> returns number one seeds for the given year (only available from 1979 onwards)
Sample Response

{
	"year": "2011",
	"season": "2010-2011",
	"number_one_seeds": "Ohio State, Kansas, Pittsburgh, Duke"
}

/final-four/{identifier} -> returns Final Four teams for the given year
Sample Response

{
	"year": "1966",
	"season": "1965-1966",
	"final_four": "UTEP, Kentucky, Duke, Utah"
}

/school-count/{identifier} -> returns number of teams for the given year
Sample Response

{
	"year": "1959",
	"season": "1958-1959",
	"schools": "23"
}

/location/{identifier} -> returns venue and city that hosted the Final Four for the given year
Sample Response

{
	"year": "1952",
	"season": "1951-1952",
	"location": "Seattle, WA",
	"venue": "Hec Edmunson Pavilion"
}

##Final Four data lists

/list/champions -> returns a list of champions sorted alphabetically
Sample Response

{
	"champions": [
		"Arizona Wildcats",
		"Arkansas Razorbacks",
		"Baylor Bears",
		"CCNY Beavers",
		"California Golden Bears",
		"Cincinnati Bearcats",
		"Duke Blue Devils",
		"Florida Gators",
		"Georgetown Hoyas",
		"Holy Cross Crusaders",
		...
	]
}

/list/teams -> returns a list of school names and nicknames sorted alphabetically
Sample Response

{
	"teams": [
		"Arizona Wildcats",
		"Arkansas Razorbacks",
		"Auburn Tigers",
		"Baylor Bears",
		"Bradley Braves",
		"Butler Bulldogs",
		"CCNY Beavers",
		"California Golden Bears",
		"Charlotte 49ers",
		"Cincinnati Bearcats",
		"Colorado Buffaloes",
		"Dartmouth Big Green",
		...
	]
}

/list/schools -> returns a list of school names sorted alphabetically
Sample Response

{
	"schools": [
		"Arizona",
		"Arkansas",
		"Auburn",
		"Baylor",
		"Bradley",
		"Butler",
		"CCNY",
		"California",
		"Charlotte",
		"Cincinnati",
		"Colorado",
		"Dartmouth",
		...
	]
}

/list/nicknames -> returns a list of school nicknames sorted alphabetically
Sample Response

{
	"nicknames": [
		"49ers",
		"Aggies",
		"Badgers",
		"Bearcats",
		"Bears",
		"Beavers",
		"Big Green",
		"Blue Demons",
		"Blue Devils",
		"Boilermakers",
		"Bonnies",
		"Braves",
		...
	]
}

/list/coaches -> returns a list of coaches sorted alphabetically
Sample Response

{
	"coaches": [
		"Adolph Rupp",
		"Al McGuire",
		"Alex Severance",
		"Alvin Julian",
		"Bebe Lee",
		"Ben Carnevale",
		"Ben Howland",
		"Bill E. Foster",
		"Bill Guthridge",
		"Bill Henderson",
		"Bill Hodges",
		"Bill Self",
		"Billy Donovan",
		"Billy Tubbs",
		"Bo Ryan",
		"Bob Feerick",
		"Bob Huggins",
		"Bob Knight",
		...
	]
}

/list/mops -> returns a list of most outstanding players sorted alphabetically
Sample Response

{
	"mops": [
		"Akeem Olajuwon, Houston*",
		"Alex Groza, Kentucky",
		"Anderson Hunt, UNLV",
		"Anthony Davis, Kentucky",
		"Arnie Ferrin, Utah",
		"Art Heyman, Duke*",
		"B. H. Born, Kansas*",
		"Bill Bradley, Princeton*",
		"Bill Russell, San Francisco",
		...
	]
}

/list/venues -> returns a list of venues sorted alphabetically
Sample Response

{
	"venues": [
		"AT&T Stadium",
		"Alamadome",
		"Astrodome",
		"Caesars Superdome",
		"Charlotte Coliseum",
		"Checkerdome",
		"Cole Field House",
		"Continental Airlines Arena",
		"Cow Palace",
		...
	]
}

/list/locations -> returns a list of locations sorted alphabetically
Sample Response

{
	"locations": [
		"Albuquerque, NM",
		"Arlington, TX",
		"Atlanta, GA",
		"Charlotte, NC",
		"College Park, MD",
		"Dallas, TX",
		"Denver, CO",
		"Detroit, MI",
		"East Rutherford, NJ",
		"Evanston, IL",
		...
	]
}

##Final Four metadata

/appearances/teams -> returns a list of every Final Four team and the year(s) they appeared
Sample Response

{
	"team_appearances": {
		"Arizona": [
			"1988",
			"1994",
			"1997",
			"2001"
		],
		"Arkansas": [
			"1941",
			"1945",
			"1978",
			"1990",
			"1994",
			"1995"
		],
		"Auburn": [
			"2019"
		],
		"Baylor": [
			"1948",
			"1950",
			"2021"
		],
		...
	}
}

/appearances/coaches -> returns a list of every Final Four coach and the teams and year(s) they appeared
Sample Response

{
	"coach_appearances": {
		"Adolph Rupp": [
			"Kentucky, 1942",
			"Kentucky, 1948",
			"Kentucky, 1949",
			"Kentucky, 1951",
			"Kentucky, 1958",
			"Kentucky, 1966"
		],
		"Al McGuire": [
			"Marquette, 1974",
			"Marquette, 1977"
		],
		"Alex Severance": [
			"Villanova, 1939"
		],
		"Alvin Julian": [
			"Holy Cross, 1947"
		],
		"Bebe Lee": [
			"Colorado, 1955"
		],
		"Ben Carnevale": [
			"North Carolina, 1946"
		],
		"Ben Howland": [
			"UCLA, 2006",
			"UCLA, 2007",
			"UCLA, 2008"
		],
		...
	}
}

/counts/team-totals -> returns a list of every Final Four team grouped by number of appearances
Sample Response

{
	"team_appearances_by_count": {
		"21": [
			"North Carolina"
		],
		"19": [
			"UCLA"
		],
		"17": [
			"Duke",
			"Kentucky"
		],
		"16": [
			"Kansas"
		],
		"11": [
			"Ohio State"
		],
		"10": [
			"Louisville",
			"Michigan State"
		],
		"8": [
			"Indiana",
			"Michigan"
		],
		"7": [
			"Villanova"
		],
		...
	}
}

/counts/coach-totals -> returns a list of every Final Four coach grouped by number of appearances
Sample Response

{
	"coach_appearances_by_count": {
		"13": [
			"Mike Krzyzewski"
		],
		"12": [
			"John Wooden"
		],
		"11": [
			"Dean Smith"
		],
		"9": [
			"Roy Williams"
		],
		"8": [
			"Tom Izzo"
		],
		"7": [
			"Rick Pitino"
		],
		"6": [
			"Adolph Rupp",
			"Denny Crum",
			"John Calipari"
		],
		"5": [
			"Bob Knight",
			"Guy Lewis",
			"Jim Boeheim",
			"Lute Olson"
		],
		...
	}
}

/counts/team-championships -> returns a list of every Final Four team grouped by number of championships
Sample Response

{
	"team_championships_by_count": {
		"11": [
			"UCLA"
		],
		"8": [
			"Kentucky"
		],
		"6": [
			"North Carolina"
		],
		"5": [
			"Duke",
			"Indiana"
		],
		"4": [
			"Kansas",
			"UConn"
		],
		...
	}
}

/counts/coach-championships -> returns a list of every Final Four coach grouped by number of championships
Sample Response

{
	"coach_championships_by_count": {
		"10": [
			"John Wooden"
		],
		"5": [
			"Mike Krzyzewski"
		],
		"4": [
			"Adolph Rupp"
		],
		"3": [
			"Bob Knight",
			"Jim Calhoun",
			"Roy Williams"
		],
		...
	}
}

Errors

400 - Invalid Request (you have specified an invalid resource or not supplied appropriate path parameters)
401 - Unauthorized (you are not authorized to use the specified endpoint)
404 - Value Not Found

Please Note

All response data is provided in string format for easy and consistent usage.
Field order in response is not guaranteed or preserved.
In order to make our API data ever-evolving, new fields could be added at any time.

Thank you

We strive to provide the most up-to-date data available. If for any reason you notice data discrepancies, please contact us immediately so we can resolve them.