get_ratings
2 creditsBasic lookupPOST /v1/get_ratings
Data refreshed · changelog
Our fighter ratings (Elo from every UFC result since 2000)
Use it when you want our Elo ratings, best first, for active fighters, overall or by weight class.
Parameters
weight_classstringoptional- e.g. Welterweight.
active_sincestring | numberoptional- Only fighters whose last fight was in this year or later.
limitintegeroptional- Max fighters (default 25).
leagueenum: mma | pfl | bellatoroptional- League. Defaults to mma. One of: mma, pfl, bellator.
Notes
- Over MCP, ask for it in plain English and the client calls
get_ratingsitself. Point any MCP client athttps://mcp.fighterapi.com/mcp?key=YOUR_API_KEY. - Each call costs 2 credits, taken before it runs and refunded if the server errors.
- Not the call you need? Find the right call by what you are trying to answer.
Request
curl -X POST https://mcp.fighterapi.com/v1/get_ratings \
-H "Content-Type: application/json" \
-H "x-api-key: YOUR_API_KEY" \
-d '{
"weight_class": "Featherweight",
"limit": 3
}'Response
json
{
"active_since": 2025,
"ratings": [
{
"rank": 1,
"fighter_id": "3949584",
"name": "Alexander Volkanovski",
"weight_class": "Featherweight",
"rating": 1690,
"last_fight": "2026-10-24T18:00:00.000Z",
"fights": 19,
"ufc_fights": 19
},
{
"rank": 2,
"fighter_id": "3031559",
"name": "Aljamain Sterling",
"weight_class": "Featherweight",
"rating": 1673,
"last_fight": "2026-04-26T00:00:00.000Z",
"fights": 23,
"ufc_fights": 23
},
{
"rank": 3,
"fighter_id": "4029275",
"name": "Movsar Evloev",
"weight_class": "Featherweight",
"rating": 1645,
"last_fight": "2026-10-24T18:00:00.000Z",
"fights": 11,
"ufc_fights": 11
}
],
"count": 3,
"method": "Elo from UFC results alone: start 1500, K 40 for a fighter's first five bouts then 24, finishes weighted 1.15, draws 0.5, no contests unrated."
}Response fields
active_sincenumberratings[]array- List of objects
ratings[].ranknumberratings[].fighter_idstringratings[].namestringratings[].weight_classstringratings[].ratingnumberratings[].last_fightstringratings[].fightsnumberratings[].ufc_fightsnumbercountnumbermethodstring
Used in
- UFC fighter database: Every fighter who has fought in the UFC since 2000: date of birth, height, reach, stance, gym, record by method, career rates and our rating. REST or MCP.
- Guide: How do I get UFC fighter Elo ratings by weight class?
Related endpoints
get_fighter5 cr
Takes the fighter_id this one returns.
Profile, UFC record by method, career rates, rating and recent fights
get_fighter_fights5 cr
Takes the fighter_id this one returns.
A fighter's full UFC history with stats, ratings and closing lines
list_events1 cr
Filters by the same limit and league.
Cards by year and status, with the main event
search_fighters1 cr
Filters by the same weight_class and limit.
Find fighters by name or nickname
Try it
500 free credits every month: 250 calls to get_ratings, and no card.