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

---