---
title: "Fighter"
method: POST
path: "/v1/get_fighter"
tags: ["Stats + aggregation"]
---

# Fighter

`POST /v1/get_fighter`

## Request

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

Use for one fighter's profile: date of birth, height, reach, stance, gym, record in the promotion by method (record; ufc_record is the same for the UFC and null for other promotions), career rates per 15 minutes from the stat sheets (significant strikes landed and absorbed, accuracy, defense, takedowns, submission attempts, control share; UFC only), current and peak rating, and the last five fights. Costs 5 credits.

## Request body

- object
  - `fighter_id` string, required: Fighter id from search_fighters.
  - `league` 'mma' | 'pfl' | 'bellator': League. Defaults to mma. One of: mma, pfl, bellator.

## Response `200`

The result, wrapped in data.

- object
  - `data` object, required
    - `fighter` object, required
    - `record` object, nullable, required
    - `ufc_record` object, nullable, required
    - `career_rates` object, nullable, required
    - `rating` object, nullable, required
    - `recent_fights` object[], required

## Other responses

- `400`: Invalid arguments.
- `401`: Missing or invalid API key.
- `402`: Not enough credits.
- `429`: Rate limited.

---

[API](https://skmtc.dev/fighterapi/apis/fighterapi-api.md) · [All operations](https://skmtc.dev/fighterapi/apis/fighterapi-api/llms.txt) · [OpenAPI document](https://skmtc.dev/fighterapi/apis/fighterapi-api/revisions/685ec093d5a4?raw)