Static reference

Search fighters

Use to find a fighter's id by name or nickname (accents optional). Returns weight class, country, pro record, number of fights in the promotion (bouts; ufc_bouts for the UFC only) and last fight date. Costs 1 credit.

post/v1/search_fighters

Request

  • Base URL: https://mcp.fighterapi.com
  • URL: https://mcp.fighterapi.com/v1/search_fighters
  • Auth: one of:
    • API key in header x-api-key
    • HTTP bearer

Request body

querystring required

Name or nickname, e.g. Topuria or 'El Matador'.

weight_classstring

e.g. Lightweight, Women's Strawweight.

limitinteger

Max results (default 20).

league'mma' | 'pfl' | 'bellator'

League. Defaults to mma. One of: mma, pfl, bellator.

Response

The result, wrapped in data.

Changes

No recorded changes to this operation across all 1 revision of this API.