# UFC DATA API -----------

## Fighters (baseURL: /Fighters/) ----------- #### FindStatsByFighterName Returns the career statistics for the selected fighter
##### Parameters:
**Fighter1:** The name of the fighter who you want to find events for
~~~~ Fighter1 (string) (required) (case sensitive): The name of any past/present UFC fighter ~~~~ ----------- **Request format: /Fighters/FindStatsByFighterName/Jon Jones**
###### example response ~~~~ { "name": "Jon Jones", "Statistics": { "TotalFights": 23, "Wins": 21, "WinRate": "0.913%", "AvgKnockdowns": 0.174, "KOs/TKOs": 5, "AvgSignificantStrikes": 60.5, "AvgTakedowns": 1.87, "AvgSubmissionAttempts": 0.478 } } ~~~~ -----------

## Events (baseURL: /Events/) ----------- #### FindEventsByFighterName Returns all the events a fighter has been a part of
##### Parameters:
**Fighter1:** The name of the fighter who you want to find events for
~~~~ Fighter1 (string) (required) (case sensitive): The name of any past/present UFC fighter ~~~~ ----------- **Request format: /Events/FindEventsByFighterName/Jon Jones**
###### example response ~~~~ [ { "_id": "65c95efb0115dbe3cb4e7c22", "Location": "Las Vegas, Nevada, USA", "Fighter 1": "Jon Jones", "Fighter 2": "Ciryl Gane", "Fighter_1_KD": 0, "Fighter_2_KD": 0, "Fighter_1_STR": 5, "Fighter_2_STR": 6, "Fighter_1_TD": 2, "Fighter_2_TD": 0, "Fighter_1_SUB": 1, "Fighter_2_SUB": 0, "Weight_Class": "Heavyweight", "Method": "SUB Guillotine Choke", "Round": 1, "Time": "2:04", "Event Name": "UFC 285", "Date": "4-Mar-23", "Winner": "Jon Jones", "FormattedDate": "2023-03-04T00:00:00.000Z" }, { "_id": "65c95efc0115dbe3cb4e8218", "Location": "Houston, Texas, USA", "Fighter 1": "Jon Jones", "Fighter 2": "Dominick Reyes", "Fighter_1_KD": 0, "Fighter_2_KD": 0, "Fighter_1_STR": 104, "Fighter_2_STR": 116, "Fighter_1_TD": 2, "Fighter_2_TD": 0, "Fighter_1_SUB": 0, "Fighter_2_SUB": 0, "Weight_Class": "Light Heavyweight", "Method": "U-DEC", "Round": 5, "Time": "5:00", "Event Name": "UFC 247", "Date": "8-Feb-20", "Winner": "Jon Jones", "FormattedDate": "2020-02-08T00:00:00.000Z" } ] ~~~~ ----------- #### FindMatchups Returns all the events a fighter has been a part of
##### Parameters: **Fighter1:** The name of the first fighter in the matchup
**Fighter2:** The name of the second fighter in the matchup
~~~~ Fighter1 (string) (required) (case sensitive): The name of any past/present UFC fighter Fighter2 (string) (required) (case sensitive): The name of any past/present UFC fighter ~~~~ **Request format: /Events/FindEventsByFighterName/Jon Jones/Daniel Cormier**
###### example response ~~~~ [ { "_id": "65c95eff0115dbe3cb4e8b9d", "Location": "Las Vegas, Nevada, USA", "Fighter 1": "Jon Jones", "Fighter 2": "Daniel Cormier", "Fighter_1_KD": 0, "Fighter_2_KD": 0, "Fighter_1_STR": 92, "Fighter_2_STR": 58, "Fighter_1_TD": 3, "Fighter_2_TD": 1, "Fighter_1_SUB": 0, "Fighter_2_SUB": 0, "Weight_Class": "Light Heavyweight", "Method": "U-DEC", "Round": 5, "Time": "5:00", "Event Name": "UFC 182", "Date": "3-Jan-15", "Winner": "Jon Jones", "FormattedDate": "2015-01-03T00:00:00.000Z" }, { "_id": "65c95efe0115dbe3cb4e86dd", "Location": "Anaheim, California, USA", "Fighter 1": "Daniel Cormier", "Fighter 2": "Jon Jones", "Fighter_1_KD": 0, "Fighter_2_KD": 1, "Fighter_1_STR": 58, "Fighter_2_STR": 95, "Fighter_1_TD": 0, "Fighter_2_TD": 0, "Fighter_1_SUB": 0, "Fighter_2_SUB": 0, "Weight_Class": "Light Heavyweight", "Method": "Overturned Kick", "Round": 3, "Time": "3:01", "Event Name": "UFC 214", "Date": "29-Jul-17", "Winner": "Daniel Cormier", "FormattedDate": "2017-07-29T00:00:00.000Z" } ] ~~~~ ----------- #### FindEventsByDateRange Returns all the events within a specified date range
##### Parameters:
**MinDate:** The lower bound of the date range for finding events
**MaxDate:** The upper bound of the date range for finding events
~~~~ MinDate (string) (required) (case sensitive): Any Date (MM/DD/YY) Fighter2 (string) (required) (case sensitive): Any Date (MM/DD/YY) ~~~~ --- **Date Format**: MM/DD/YY **Request format: /Events/FindEventsByDateRange/2-1-22/28-1-22**
###### example response ~~~~ [ { "_id": "65c95efb0115dbe3cb4e7e60", "Location": "Las Vegas, Nevada, USA", "Fighter 1": "Malcolm Gordon", "Fighter 2": "Denys Bondar", "Fighter_1_KD": 0, "Fighter_2_KD": 0, "Fighter_1_STR": 3, "Fighter_2_STR": 4, "Fighter_1_TD": 1, "Fighter_2_TD": 1, "Fighter_1_SUB": 1, "Fighter_2_SUB": 0, "Weight_Class": "Flyweight", "Method": "KO/TKO", "Round": 1, "Time": "1:22", "Event Name": "UFC Fight Night", "Date": "5-Feb-22", "Winner": "Malcolm Gordon", "FormattedDate": "2022-02-05T00:00:00.000Z" }, { "_id": "65c95efb0115dbe3cb4e7e56", "Location": "Las Vegas, Nevada, USA", "Fighter 1": "Shavkat Rakhmonov", "Fighter 2": "Carlston Harris", "Fighter_1_KD": 1, "Fighter_2_KD": 0, "Fighter_1_STR": 13, "Fighter_2_STR": 10, "Fighter_1_TD": 1, "Fighter_2_TD": 0, "Fighter_1_SUB": 0, "Fighter_2_SUB": 0, "Weight_Class": "Welterweight", "Method": "KO/TKO Kick", "Round": 1, "Time": "4:10", "Event Name": "UFC Fight Night", "Date": "5-Feb-22", "Winner": "Shavkat Rakhmonov", "FormattedDate": "2022-02-05T00:00:00.000Z" }, { "_id": "65c95efb0115dbe3cb4e7e5d", "Location": "Las Vegas, Nevada, USA", "Fighter 1": "Alexis Davis", "Fighter 2": "Julija Stoliarenko", "Fighter_1_KD": 0, "Fighter_2_KD": 0, "Fighter_1_STR": 85, "Fighter_2_STR": 56, "Fighter_1_TD": 1, "Fighter_2_TD": 0, "Fighter_1_SUB": 0, "Fighter_2_SUB": 3, "Weight_Class": "Women's Bantamweight", "Method": "U-DEC", "Round": 3, "Time": "5:00", "Event Name": "UFC Fight Night", "Date": "5-Feb-22", "Winner": "Alexis Davis", "FormattedDate": "2022-02-05T00:00:00.000Z" } ] ~~~~ -----------
## Filter (baseURL: / ----------- #### Filter Returns all the events a fighter has been a part of
##### Parameters:
**fighter1 (string):** The name of the fighter who you want to find events for
**fighter2 (string):** The 2nd name of the fighter who you want to find events for
**weightClass (string):** The weightclass you want to find the event(s) for
**winner (string):** The winner of the event(s) you're searching for
**winMethod (string):** The method in which the fight(s) was won
~~~~ fighter1 (string) (optional) (case sensitive): The name of any past/present UFC fighter fighter2 (string) (optional) (case sensitive): The name of any past/present UFC fighter ~~~~ ~~~~ weightClass (string) (optional) (case sensitive): options: - Women's Strawweight - Women's Flyweight - Women's Bantamweight - Flyweight - Bantamweight - Featherweight - Lightweight - Welterweight - Middleweight - Light Heavyweight - Heavyweight ~~~~ ~~~~ winner (string) (optional) (case sensitive): The name of any UFC fighter ~~~~ ~~~~ winMethod (string) (optional) (case sensitive): options: SUB: submission of any kind KO/TKO: Knockout or TKO of any kind DEC: decision (unanymous or split) ~~~~ ----------- **Request format:
/Filter?fighter1=Jon Jones&fighter2=Daniel Cormier&weightClass=Light Heavyweight&winMethod=DEC&winner=Jon Jones**
###### example response ~~~~ [ { "_id": "65c95eff0115dbe3cb4e8b9d", "Location": "Las Vegas, Nevada, USA", "Fighter 1": "Jon Jones", "Fighter 2": "Daniel Cormier", "Fighter_1_KD": 0, "Fighter_2_KD": 0, "Fighter_1_STR": 92, "Fighter_2_STR": 58, "Fighter_1_TD": 3, "Fighter_2_TD": 1, "Fighter_1_SUB": 0, "Fighter_2_SUB": 0, "Weight_Class": "Light Heavyweight", "Method": "U-DEC", "Round": 5, "Time": "5:00", "Event Name": "UFC 182", "Date": "3-Jan-15", "Winner": "Jon Jones", "FormattedDate": "2015-01-03T00:00:00.000Z" } ] ~~~~

## Thank you, i hope you are satisfied with your UFC Data API experience ### Any issues or questions, do not hesitate to contact: #### dolphinnoirbusiness@gmail.com -----------