{"openapi":"3.1.0","info":{"title":"MMA / UFC API","version":"1.0.0","description":"Live MMA and UFC data as an API — clean JSON, no key. Get the UFC schedule and each event's full fight card (every bout, both fighters, weight class, status and result), browse the official fighter rankings across all 24 divisions (champions and contenders, with rank movement), and open any fighter's profile — nickname, height, weight, reach, stance, fighting style, citizenship, association and their win-loss-draw record by method. Search fighters by name and read the latest UFC news. Live data sourced continuously from ESPN. Distinct combat-sports coverage — ideal for MMA apps, fantasy and betting tools, fan sites, dashboards and Discord bots. 6 data endpoints. Authenticated with an x-oanor-key; fair-use rate limits per plan.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/mma-api","description":"oanor gateway"}],"tags":[{"name":"Events"},{"name":"Rankings"},{"name":"Fighters"},{"name":"News"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/event":{"get":{"operationId":"get_v1_event","tags":["Events"],"summary":"A single event's fight card","description":"","parameters":[{"name":"id","in":"query","required":true,"description":"Event id","schema":{"type":"string"},"example":"600058949"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"event":{"id":"600058949","date":"2026-06-06T21:00Z","name":"UFC Fight Night: Muhammad vs. Bonfim","fights":[{"id":"401870073","result":{"method":"Final","winner":"Ketlen Souza"},"status":"Final","fighters":[{"name":"Ariane Carnelossi","record":"15-5-0","winner":false},{"name":"Ketlen Souza","record":"17-6-0","winner":true}],"completed":true},{"id":"401864366","result":{"method":"Final","winner":"Jeisla Chaves"},"status":"Final","fighters":[{"name":"Yuneisy Duben","record":"6-2-0","winner":false},{"name":"Jeisla Chaves","record":"8-0-0","winner":true}],"completed":true},{"id":"401870072","result":{"method":"Final","winner":"Joanderson Brito"},"status":"Final","fighters":[{"name":"Joanderson Brito","record":"19-5-1","winner":true},{"name":"Jordan Leavitt","record":"13-4-0","winner":false}],"completed":true},{"id":"401870074","result":{"method":"Final","winner":"Chelsea Chandler"},"status":"Final","fighters":[{"name":"Priscila Cachoeira","record":"13-9-0","winner":false},{"name":"Chelsea Chandler","record":"7-4-0","winner":true}],"completed":true},{"id":"401867213","result":{"method":"Final","winner":"Édgar Cháirez"},"status":"Final","fighters":[{"name":"Bruno Silva","record":"15-9-2","winner":false},{"name":"Édgar Cháirez","record":"14-6-0","winner":true}],"completed":true},{"id":"401874287","result":{"method":"Final","winner":"Marcus McGhee"},"status":"Final","fighters":[{"name":"Marcus McGhee","record":"11-2-0","winner":true},{"name":"John Yannis","record":"10-5-0","winner":false}],"completed":true},{"id":"401874286","result":{"method":"Final","winner":"Alessandro Costa"},"status":"Final","fighters":[{"name":"Matt Schnell","record":"17-11-0","winner":false},{"name":"Alessandro Costa","record":"16-5-0","winner":true}],"completed":true},{"id":"401874285","result":{"method":"Final","winner":"Iwo Baraniewski"},"status":"Final","fighters":[{"name":"Junior Tafa","record":"7-6-0","winner":false},{"name":"Iwo Baraniewski","record":"9-0-0","winner":true}],"completed":true},{"id":"401874284","result":{"method":"Final","winner":"Bryce Mitchell"},"status":"Final","fighters":[{"name":"Bryce Mitchell","record":"19-4-0","winner":true},{"name":"Santiago Luna","record":"8-1-0","winner":false}],"completed":true},{"id":"401870067","result":{"method":"Final","winner":"Tom Nolan"},"status":"Final","fighters":[{"name":"Farés Ziam","record":"18-5-0","winner":false},{"name":"Tom Nolan","record":"11-1-0","winner":true}],"completed":true},{"id":"401870062","result":{"method":"Final","winner":"Brendan Allen"},"status":"Final","fighters":[{"name":"Brendan Allen","record":"27-7-0","winner":true},{"name":"Edmen Shahbazyan","record":"16-6-0","winner":false}],"completed":true},{"id":"401864364","result":{"method":"Final","winner":"Gabriel Bonfim"},"status":"Final","fighters":[{"name":"Belal Muhammad","record":"24-6-0","winner":false},{"name":"Gabriel Bonfim","record":"20-1-0","winner":true}],"completed":true}],"status":"Final","completed":true,"short_name":"UFC Fight Night","fight_count":12}},"meta":{"timestamp":"2026-06-07T16:46:38.468Z","request_id":"bbae79c6-5387-448a-a09f-abdc60e928cd"},"status":"ok","message":"Event retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/events":{"get":{"operationId":"get_v1_events","tags":["Events"],"summary":"UFC events & fight cards","description":"","parameters":[{"name":"dates","in":"query","required":false,"description":"Date range YYYYMMDD-YYYYMMDD","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":1,"events":[{"id":"600058949","date":"2026-06-06T21:00Z","name":"UFC Fight Night: Muhammad vs. Bonfim","fights":[{"id":"401870073","result":{"method":"Final","winner":"Ketlen Souza"},"status":"Final","fighters":[{"name":"Ariane Carnelossi","record":"15-5-0","winner":false},{"name":"Ketlen Souza","record":"17-6-0","winner":true}],"completed":true},{"id":"401864366","result":{"method":"Final","winner":"Jeisla Chaves"},"status":"Final","fighters":[{"name":"Yuneisy Duben","record":"6-2-0","winner":false},{"name":"Jeisla Chaves","record":"8-0-0","winner":true}],"completed":true},{"id":"401870072","result":{"method":"Final","winner":"Joanderson Brito"},"status":"Final","fighters":[{"name":"Joanderson Brito","record":"19-5-1","winner":true},{"name":"Jordan Leavitt","record":"13-4-0","winner":false}],"completed":true},{"id":"401870074","result":{"method":"Final","winner":"Chelsea Chandler"},"status":"Final","fighters":[{"name":"Priscila Cachoeira","record":"13-9-0","winner":false},{"name":"Chelsea Chandler","record":"7-4-0","winner":true}],"completed":true},{"id":"401867213","result":{"method":"Final","winner":"Édgar Cháirez"},"status":"Final","fighters":[{"name":"Bruno Silva","record":"15-9-2","winner":false},{"name":"Édgar Cháirez","record":"14-6-0","winner":true}],"completed":true},{"id":"401874287","result":{"method":"Final","winner":"Marcus McGhee"},"status":"Final","fighters":[{"name":"Marcus McGhee","record":"11-2-0","winner":true},{"name":"John Yannis","record":"10-5-0","winner":false}],"completed":true},{"id":"401874286","result":{"method":"Final","winner":"Alessandro Costa"},"status":"Final","fighters":[{"name":"Matt Schnell","record":"17-11-0","winner":false},{"name":"Alessandro Costa","record":"16-5-0","winner":true}],"completed":true},{"id":"401874285","result":{"method":"Final","winner":"Iwo Baraniewski"},"status":"Final","fighters":[{"name":"Junior Tafa","record":"7-6-0","winner":false},{"name":"Iwo Baraniewski","record":"9-0-0","winner":true}],"completed":true},{"id":"401874284","result":{"method":"Final","winner":"Bryce Mitchell"},"status":"Final","fighters":[{"name":"Bryce Mitchell","record":"19-4-0","winner":true},{"name":"Santiago Luna","record":"8-1-0","winner":false}],"completed":true},{"id":"401870067","result":{"method":"Final","winner":"Tom Nolan"},"status":"Final","fighters":[{"name":"Farés Ziam","record":"18-5-0","winner":false},{"name":"Tom Nolan","record":"11-1-0","winner":true}],"completed":true},{"id":"401870062","result":{"method":"Final","winner":"Brendan Allen"},"status":"Final","fighters":[{"name":"Brendan Allen","record":"27-7-0","winner":true},{"name":"Edmen Shahbazyan","record":"16-6-0","winner":false}],"completed":true},{"id":"401864364","result":{"method":"Final","winner":"Gabriel Bonfim"},"status":"Final","fighters":[{"name":"Belal Muhammad","record":"24-6-0","winner":false},{"name":"Gabriel Bonfim","record":"20-1-0","winner":true}],"completed":true}],"status":"Final","completed":true,"short_name":"UFC Fight Night","fight_count":12}]},"meta":{"timestamp":"2026-06-07T16:46:38.584Z","request_id":"698d1c73-9b97-490b-ae13-a408673bd9fe"},"status":"ok","message":"Events retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/rankings":{"get":{"operationId":"get_v1_rankings","tags":["Rankings"],"summary":"Fighter rankings by division","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":24,"divisions":[{"type":"pound-for-pound","ranks":[{"id":"3088812","rank":1,"trend":"-","fighter":"Kamaru Usman"},{"id":"4285679","rank":3,"trend":"-","fighter":"Israel Adesanya"},{"id":"3933168","rank":4,"trend":"-","fighter":"Francis Ngannou"},{"id":"3949584","rank":5,"trend":"-","fighter":"Alexander Volkanovski"},{"id":"2506250","rank":6,"trend":"-","fighter":"Jan Blachowicz"},{"id":"2506549","rank":7,"trend":"-","fighter":"Dustin Poirier"},{"id":"4189320","rank":8,"trend":"+2","fighter":"Deiveson Figueiredo"},{"id":"2504951","rank":9,"trend":"-","fighter":"Stipe Miocic"},{"id":"2504169","rank":10,"trend":"-","fighter":"Charles Oliveira"}],"division":"Men's Pound for Pound Rankings"},{"type":"womens-pound-for-pound","ranks":[{"id":"2516131","rank":1,"trend":"-","fighter":"Amanda Nunes"},{"id":"2554705","rank":2,"trend":"-","fighter":"Valentina Shevchenko"},{"id":"2354564","rank":3,"trend":"-","fighter":"Cris Cyborg"},{"id":"3032973","rank":4,"trend":"-","fighter":"Rose Namajunas"},{"id":"4350762","rank":5,"trend":"-","fighter":"Zhang Weili"},{"id":"3024395","rank":6,"trend":"-","fighter":"Jessica Andrade"},{"id":"2552777","rank":8,"trend":"-","fighter":"Germaine de Randamie"},{"id":"3028404","rank":9,"trend":"-","fighter":"Holly Holm"},{"id":"4026490","rank":10,"trend":"-","fighter":"Katlyn Cerminara"}],"division":"Women's Pound for Pound Rankings"},{"type":"heavyweight-champions","ranks":[{"id":"3933168","rank":1,"trend":"-","fighter":"Francis Ngannou"}],"division":"Heavyweight Division Champions (Up to 265 pounds)"},{"type":"light-heavyweight-champions","ranks":[{"id":"2506250","rank":1,"trend":"-","fighter":"Jan Blachowicz"}],"division":"Light Heavyweight Division Champions (Up to 205 pounds)"},{"type":"middleweight-champions","ranks":[{"id":"4285679","rank":1,"trend":"-","fighter":"Israel Adesanya"}],"division":"Middleweight Division Champions (Up to 185 pounds)"},{"type":"welterweight-champions","ranks":[{"id":"3088812","rank":1,"trend":"-","fighter":"Kamaru Usman"}],"division":"Welterweight Division Champions (Up to 170 pounds)"},{"type":"lightweight-champions","ranks":[{"id":"2504169","rank":1,"trend":"-","fighter":"Charles Oliveira"}],"division":"Lightweight Division Champions (Up to 155 pounds)"},{"type":"featherweight-champions","ranks":[{"id":"3949584","rank":1,"trend":"-","fighter":"Alexander Volkanovski"}],"division":"Featherweight Division Champions (Up to 145 pounds)"},{"type":"bantamweight-champions","ranks":[{"id":"3031559","rank":1,"trend":"-","fighter":"Aljamain Sterling"}],"division":"Bantamweight Division Champions (Up to 135 pounds)"},{"type":"flyweight-champions","ranks":[{"id":"4189320","rank":1,"trend":"-","fighter":"Deiveson Figueiredo"}],"division":"Flyweight Division Champions (Up to 125 pounds)"},{"type":"womens-bantamweight-champions","ranks":[{"id":"2516131","rank":1,"trend":"-","fighter":"Amanda Nunes"}],"division":"Women's Bantamweight Division Champions (Up to 135 pounds)"},{"type":"womens-strawweight-champions","ranks":[{"id":"3032973","rank":1,"trend":"-","fighter":"Rose Namajunas"}],"division":"Women's Strawweight Division Champions (Up to 115 pounds)"},{"type":"heavyweight","ranks":[{"id":"3933168","rank":1,"trend":"-","fighter":"Francis Ngannou"},{"id":"2504951","rank":2,"trend":"-","fighter":"Stipe Miocic"},{"id":"2560713","rank":3,"trend":"-","fighter":"Derrick Lewis"},{"id":"4426000","rank":4,"trend":"-","fighter":"Ciryl Gane"},{"id":"3922557","rank":5,"trend":"-","fighter":"Curtis Blaydes"},{"id":"2993650","rank":6,"trend":"-","fighter":"Alexander Volkov"},{"id":"4410084","rank":7,"trend":"-","fighter":"Jairzinho Rozenstruik"},{"id":"2335516","rank":8,"trend":"-","fighter":"Alistair Overeem"},{"id":"2335530","rank":9,"trend":"-","fighter":"Ryan Bader"}],"division":"Heavyweight Division Rankings (Up to 265 pounds)"},{"type":"light-heavyweight","ranks":[{"id":"2506250","rank":2,"trend":"-","fighter":"Jan Blachowicz"},{"id":"2504929","rank":3,"trend":"-","fighter":"Glover Teixeira"},{"id":"3156612","rank":4,"trend":"-","fighter":"Jiří Procházka"},{"id":"4079314","rank":5,"trend":"-","fighter":"Aleksandar Rakic"},{"id":"3955014","rank":6,"trend":"-","fighter":"Vadim Nemkov"},{"id":"4233039","rank":7,"trend":"-","fighter":"Dominick Reyes"},{"id":"3112020","rank":8,"trend":"-","fighter":"Corey Anderson"},{"id":"2335530","rank":9,"trend":"-","fighter":"Ryan Bader"},{"id":"3045798","rank":10,"trend":"-","fighter":"Thiago Santos"}],"division":"Light Heavyweight Division Rankings (Up to 205 pounds)"},{"type":"middleweight","ranks":[{"id":"4285679","rank":1,"trend":"-","fighter":"Israel Adesanya"},{"id":"3009717","rank":2,"trend":"-","fighter":"Robert Whittaker"},{"id":"4080826","rank":3,"trend":"-","fighter":"Paulo Costa"},{"id":"3154860","rank":5,"trend":"-","fighter":"Jared Cannonier"},{"id":"4001851","rank":6,"trend":"-","fighter":"Marvin Vettori"},{"id":"2560056","rank":7,"trend":"-","fighter":"Derek Brunson"},{"id":"3897436","rank":8,"trend":"-","fighter":"Darren Till"},{"id":"3074102","rank":9,"trend":"-","fighter":"Jack Hermansson"},{"id":"2431313","rank":10,"trend":"-","fighter":"Gegard Mousasi"}],"division":"Middleweight Division Rankings (Up to 185 pounds)"},{"type":"welterweight","ranks":[{"id":"3088812","rank":1,"trend":"-","fighter":"Kamaru Usman"},{"id":"3088810","rank":2,"trend":"-","fighter":"Colby Covington"},{"id":"2500691","rank":3,"trend":"-","fighter":"Douglas Lima"},{"id":"3152929","rank":4,"trend":"-","fighter":"Leon Edwards"},{"id":"3090197","rank":5,"trend":"-","fighter":"Gilbert Burns"},{"id":"2615077","rank":6,"trend":"-","fighter":"Stephen Thompson"},{"id":"2960681","rank":7,"trend":"-","fighter":"Michael Chiesa"},{"id":"3045887","rank":8,"trend":"-","fighter":"Vicente Luque"},{"id":"2500857","rank":9,"trend":"-","fighter":"Jorge Masvidal"},{"id":"2501814","rank":10,"trend":"-","fighter":"Rory MacDonald"}],"division":"Welterweight Division Rankings (Up to 170 pounds)"},{"type":"lightweight","ranks":[{"id":"2504169","rank":1,"trend":"-","fighter":"Charles Oliveira"},{"id":"2506549","rank":2,"trend":"-","fighter":"Dustin Poirier"},{"id":"3022345","rank":3,"trend":"-","fighter":"Justin Gaethje"},{"id":"2504988","rank":4,"trend":"-","fighter":"Michael Chandler"},{"id":"3085551","rank":5,"trend":"-","fighter":"Beneil Dariush"},{"id":"3109135","rank":6,"trend":"-","fighter":"Dan Hooker"},{"id":"2335687","rank":7,"trend":"-","fighter":"Rafael Dos Anjos"},{"id":"3332412","rank":8,"trend":"-","fighter":"Islam Makhachev"},{"id":"3099985","rank":9,"trend":"-","fighter":"Paul Felder"},{"id":"4021934","rank":10,"trend":"-","fighter":"Gregor Gillespie"}],"division":"Lightweight Division Rankings (Up to 155 pounds)"},{"type":"featherweight","ranks":[{"id":"3949584","rank":1,"trend":"-","fighter":"Alexander Volkanovski"},{"id":"2614933","rank":2,"trend":"-","fighter":"Max Holloway"},{"id":"2532870","rank":3,"trend":"-","fighter":"Patricio Pitbull"},{"id":"3045737","rank":4,"trend":"-","fighter":"Brian Ortega"},{"id":"3164030","rank":6,"trend":"-","fighter":"Calvin Kattar"},{"id":"3155420","rank":7,"trend":"-","fighter":"Yair Rodriguez"},{"id":"2501685","rank":8,"trend":"-","fighter":"Chan Sung Jung"},{"id":"4011299","rank":9,"trend":"-","fighter":"Josh Emmett"},{"id":"2526299","rank":10,"trend":"-","fighter":"Edson Barboza"}],"division":"Featherweight Division Rankings (Up to 145 pounds)"},{"type":"bantamweight","ranks":[{"id":"3031559","rank":1,"trend":"-","fighter":"Aljamain Sterling"},{"id":"4293517","rank":2,"trend":"-","fighter":"Petr Yan"},{"id":"4294504","rank":3,"trend":"-","fighter":"Cory Sandhagen"},{"id":"3163637","rank":4,"trend":"-","fighter":"Cody Garbrandt"},{"id":"3090451","rank":5,"trend":"-","fighter":"Rob Font"},{"id":"2447641","rank":6,"trend":"-","fighter":"José Aldo"},{"id":"2335694","rank":7,"trend":"-","fighter":"Frankie Edgar"},{"id":"3045734","rank":8,"trend":"-","fighter":"Pedro Munhoz"},{"id":"2553310","rank":9,"trend":"-","fighter":"Marlon Moraes"},{"id":"2354364","rank":10,"trend":"-","fighter":"Raphael Assuncao"}],"division":"Bantamweight Division Rankings (Up to 135 pounds)"},{"type":"flyweight","ranks":[{"id":"4189320","rank":1,"trend":"-","fighter":"Deiveson Figueiredo"},{"id":"3027545","rank":2,"trend":"-","fighter":"Brandon Moreno"},{"id":"3081236","rank":2,"trend":"-","fighter":"Adriano Moraes"},{"id":"2512089","rank":4,"trend":"-","fighter":"Demetrious Johnson"},{"id":"4064692","rank":5,"trend":"-","fighter":"Askar Askarov"},{"id":"3155425","rank":6,"trend":"-","fighter":"Alex Perez"},{"id":"2560746","rank":7,"trend":"-","fighter":"Alexandre Pantoja"},{"id":"4243885","rank":8,"trend":"-","fighter":"Kai Kara-France"},{"id":"4239928","rank":9,"trend":"-","fighter":"Brandon Royval"},{"id":"4280789","rank":10,"trend":"-","fighter":"Rogerio Bontorin"}],"division":"Flyweight Division Rankings (Up to 125 pounds)"},{"type":"womens-bantamweight","ranks":[{"id":"2516131","rank":1,"trend":"-","fighter":"Amanda Nunes"},{"id":"2552777","rank":2,"trend":"-","fighter":"Germaine de Randamie"},{"id":"2951361","rank":3,"trend":"-","fighter":"Julianna Peña"},{"id":"3028404","rank":5,"trend":"-","fighter":"Holly Holm"},{"id":"3136286","rank":6,"trend":"-","fighter":"Irene Aldana"},{"id":"3154898","rank":7,"trend":"-","fighter":"Yana Santos"},{"id":"4039865","rank":8,"trend":"-","fighter":"Ketlen Vieira"},{"id":"2995167","rank":9,"trend":"-","fighter":"Raquel Pennington"},{"id":"4334306","rank":10,"trend":"-","fighter":"Macy Chiasson"}],"division":"Women's Bantamweight Division Rankings (Up to 135 pounds)"},{"type":"womens-strawweight","ranks":[{"id":"3032973","rank":1,"trend":"-","fighter":"Rose Namajunas"},{"id":"4350762","rank":2,"trend":"-","fighter":"Zhang Weili"},{"id":"2559934","rank":4,"trend":"-","fighter":"Carla Esparza"},{"id":"4275487","rank":5,"trend":"-","fighter":"Yan Xiaonan"},{"id":"4379258","rank":6,"trend":"-","fighter":"Marina Rodriguez"},{"id":"4021217","rank":7,"trend":"-","fighter":"Mackenzie Dern"},{"id":"3011878","rank":8,"trend":"-","fighter":"Claudia Gadelha"},{"id":"2951504","rank":9,"trend":"-","fighter":"Michelle Waterson-Gomez"},{"id":"3032972","rank":10,"trend":"-","fighter":"Tecia Pennington"}],"division":"Women's Strawweight Division Rankings (Up to 115 pounds)"},{"type":"womens-flyweight-champions","ranks":[{"id":"2554705","rank":1,"trend":"-","fighter":"Valentina Shevchenko"}],"division":"Women's Flyweight Division Champions (Up to 125 pounds)"},{"type":"womens-flyweight","ranks":[{"id":"2554705","rank":1,"trend":"-","fighter":"Valentina Shevchenko"},{"id":"3024395","rank":2,"trend":"-","fighter":"Jessica Andrade"},{"id":"4026490","rank":3,"trend":"-","fighter":"Katlyn Cerminara"},{"id":"3022348","rank":4,"trend":"-","fighter":"Jennifer Maia"},{"id":"3028064","rank":5,"trend":"-","fighter":"Joanne Wood"},{"id":"3075001","rank":6,"trend":"-","fighter":"Lauren Murphy"},{"id":"4257422","rank":7,"trend":"-","fighter":"Juliana Velasquez"},{"id":"3924103","rank":8,"trend":"-","fighter":"Ilima-Lei Macfarlane"},{"id":"4085155","rank":9,"trend":"-","fighter":"Cynthia Calvillo"},{"id":"2554674","rank":10,"trend":"-","fighter":"Liz Carmouche"}],"division":"Women's Flyweight Division Rankings (Up to 125 pounds)"}]},"meta":{"timestamp":"2026-06-07T16:46:38.827Z","request_id":"96a92398-440f-4330-9d26-43e16529fcd3"},"status":"ok","message":"Rankings retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/fighter":{"get":{"operationId":"get_v1_fighter","tags":["Fighters"],"summary":"Fighter profile","description":"","parameters":[{"name":"id","in":"query","required":true,"description":"Fighter id","schema":{"type":"string"},"example":"3088812"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"fighter":{"id":"3088812","age":39,"name":"Kamaru Usman","reach":"76\"","active":true,"gender":"MALE","height":"6' 0\"","record":[{"label":"Wins-Losses-Draws","value":"21-4-0"},{"label":"Technical Knockout-Technical Knockout Losses","value":"9-1"},{"label":"Submissions-Submission Losses","value":"1-1"}],"stance":"Switch","weight":"171 lbs","headshot":"https://a.espncdn.com/i/headshots/mma/players/full/3088812.png","nickname":"Nigerian Nightmare","last_name":"Usman","first_name":"Kamaru","association":"ONX Sports","citizenship":"Nigeria","weight_class":"Welterweight","date_of_birth":"11/5/1987","fighting_style":"Striker,Freestyle"}},"meta":{"timestamp":"2026-06-07T16:46:39.671Z","request_id":"fa35a080-b05e-4f67-9519-9184fd7b4fd7"},"status":"ok","message":"Fighter retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/search":{"get":{"operationId":"get_v1_search","tags":["Fighters"],"summary":"Search fighters","description":"","parameters":[{"name":"query","in":"query","required":true,"description":"Fighter name","schema":{"type":"string"},"example":"jon jones"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":4,"query":"jon jones","fighters":[{"id":"732312d4-ec2d-f307-e7cb-7a8b04f141d0","name":"Jon Jones","image":"https://a.espncdn.com/i/headshots/mma/players/full/2335639.png"},{"id":"0b96203a-7c7a-34c8-8ef1-54f6f9721aa3","name":"Weder Aparecido"},{"id":"23282200-c473-35ce-a261-bc9cfe04c47f","name":"Jon Jones","image":"https://a.espncdn.com/i/headshots/college-football/players/full/4680602.png","subtitle":"UTSA Roadrunners"},{"id":"3859776d-213b-b76c-059d-c4d226004914","name":"Jon Jones","subtitle":"Bethel (TN) Wildcats"}]},"meta":{"timestamp":"2026-06-07T16:46:39.850Z","request_id":"d6750fb2-cb57-4594-ab34-b9809135ed20"},"status":"ok","message":"Fighters retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/news":{"get":{"operationId":"get_v1_news","tags":["News"],"summary":"UFC news","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":6,"articles":[{"link":"https://www.espn.com/mma/story/_/id/48978261/ufc-white-pereira-surpasses-jones-goat-win-vs-gane","type":"HeadlineNews","image":"https://a.espncdn.com/photo/2025/1005/r1555849_600x400_3-2.jpg","headline":"UFC's White: Pereira surpasses Jones as GOAT with win vs. Gane","published":"2026-06-06T14:05:36Z","description":"UFC president Dana White believes two-weight UFC champion Alex Pereira will surpass Jon Jones as the greatest MMA fighter of all time if he beats Ciryl Gane at the White House."},{"link":"https://www.espn.com/mma/story/_/id/48976727/hearn-advises-aspinall-not-fight-current-ufc-contract","type":"HeadlineNews","image":"https://a.espncdn.com/photo/2025/1020/r1562751_600x400_3-2.jpg","headline":"Hearn: Aspinall shouldn't fight Pereira-Gane winner under UFC deal","published":"2026-06-05T19:13:35Z","description":"British boxing promoter Eddie Hearn has advised UFC heavyweight champion Tom Aspinall not to defend his title vs. the winner of  the Alex Pereira-Ciryl Gane bout under the terms of his current contract."},{"link":"https://www.espn.com/mma/story/_/id/48949502/ranking-mma-unbeaten-fighters-ufc-pfl","type":"Story","image":"https://a.espncdn.com/photo/2026/0602/r1667313_1296x729_16-9.jpg","headline":"Who is the best undefeated fighter in MMA?","published":"2026-06-05T11:40:38Z","description":"There are plenty of unbeaten fighters in MMA. We rank the select few who stand out from the rest."},{"link":"https://www.espn.com/mma/story/_/id/48895889/ufc-white-house-buzz-freedom-250-updates-news-analysis-ilia-topuria-vs-justin-gaethje","type":"Story","image":"https://a.espncdn.com/photo/2026/0528/r1664629_1296x729_16-9.jpg","headline":"UFC White House buzz: Expect a UFC show that 'tells the story of America'","published":"2026-06-05T00:01:24Z","description":"The latest news and information from Washington, D.C., where the UFC will host its White House show on June 14."},{"link":"https://www.espn.com/mma/story/_/id/48946908/ufc-freedom-250-white-house-claw","type":"Story","image":"https://a.espncdn.com/photo/2026/0601/r1666675_1296x729_16-9.jpg","headline":"Everything to know about the UFC White House centerpiece: the claw","published":"2026-06-04T12:17:14Z","description":"The UFC at the White House stage is a 92-foot-tall behemoth usually reserved for music festival headliners."},{"link":"https://www.espn.com/mma/story/_/id/21807736/mma-divisional-rankings-ufc-pfl-rankings-weight-class","type":"Columnist","image":"https://a.espncdn.com/photo/2026/0601/r1666661_608x342_16-9.jpg","headline":"Song secure in bantamweight rankings after beating another ex-champ","published":"2026-06-02T12:28:40Z","description":"Here's a look at every weight class to determine the best of the best in UFC, PFL and beyond."}]},"meta":{"timestamp":"2026-06-07T16:46:39.970Z","request_id":"b18e279e-9a25-4dcb-8102-5c5a20efdc26"},"status":"ok","message":"News retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Spec","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"service":"mma-api","endpoints":{"GET /v1/meta":"This document.","GET /v1/news":"UFC news.","GET /v1/event":"A single event's full fight card by id.","GET /v1/events":"UFC events & fight cards (dates=YYYYMMDD-YYYYMMDD).","GET /v1/search":"Search fighters by name.","GET /v1/fighter":"Fighter profile by id.","GET /v1/rankings":"Fighter rankings by division (champions + contenders)."},"description":"MMA / UFC data: event fight cards and results, fighter rankings by division, fighter profiles, fighter search and UFC news. Real live data, no key."},"meta":{"timestamp":"2026-06-07T16:46:40.059Z","request_id":"6aecae90-9d17-489a-b96f-89d40e11c6a8"},"status":"ok","message":"Meta","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":3100,"rps_limit":5,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":750,"monthly_call_quota":52000,"rps_limit":15,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":3300,"monthly_call_quota":290000,"rps_limit":30,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":9700,"monthly_call_quota":1350000,"rps_limit":80,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/mma-api"}