get_fight

5 creditsStats + aggregationPOST /v1/get_fight

One fight: result, full stat sheets, round-by-round lines, ratings and odds

Use it when you need everything about one fight on one call: both stat sheets, the round-by-round lines, ratings before and after, and each book's line.

Parameters

bout_idstringrequired: Fight id (bout_id) from get_event or get_fighter_fights.

Notes

Over MCP, ask for it in plain English and the client calls get_fight itself. Point any MCP client at https://mcp.fighterapi.com/mcp?key=YOUR_API_KEY.
Each call costs 5 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_fight \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "bout_id": "401612970"
}'

Response

json

{
  "bout": {
    "bout_id": "401612970",
    "event_id": "600039753",
    "event_name": "UFC 298: Volkanovski vs. Topuria",
    "event_date": "2024-02-17",
    "starts_at": "2024-02-18T03:00:00.000Z",
    "weight_class": "Featherweight",
    "card_segment": "main",
    "match_number": 1,
    "title_fight": true,
    "scheduled_rounds": 5,
    "status": "final",
    "fighter_a": "3949584",
    "fighter_a_name": "Alexander Volkanovski",
    "fighter_b": "4350812",
    "fighter_b_name": "Ilia Topuria",
    "winner": "4350812",
    "method": "kotko",
    "method_display": "KO/TKO",
    "end_round": 2,
    "end_clock": "3:32",
    "duration_seconds": 512,
    "judges_scores": null,
    "referee": "Jason Herzog"
  },
  "fighters": [
    {
      "fighter_id": "3949584",
      "name": "Alexander Volkanovski",
      "stats": {
        "fighter_id": "3949584",
        "knock_downs": 0,
        "total_strikes_attempted": 107,
        "total_strikes_landed": 47,
        "sig_strikes_attempted": 107,
        "sig_strikes_landed": 47,
        "sig_distance_head_attempted": 67,
        "sig_distance_head_landed": 21,
        "sig_distance_body_attempted": 18,
        "sig_distance_body_landed": 8,
        "sig_distance_leg_attempted": 17,
        "sig_distance_leg_landed": 15,
        "sig_clinch_head_attempted": 1,
        "sig_clinch_head_landed": 0,
        "sig_clinch_body_attempted": 4,
        "sig_clinch_body_landed": 3,
        "sig_clinch_leg_attempted": 0,
        "sig_clinch_leg_landed": 0,
        "sig_ground_head_attempted": 0,
        "sig_ground_head_landed": 0,
        "sig_ground_body_attempted": 0,
        "sig_ground_body_landed": 0,
        "sig_ground_leg_attempted": 0,
        "sig_ground_leg_landed": 0,
        "takedowns_attempted": 0,
        "takedowns_landed": 0,
        "takedowns_slams": 0,
        "takedown_accuracy": 0,
        "target_breakdown_head": 0.309,
        "target_breakdown_body": 0.5,
        "target_breakdown_leg": 0.882,
        "pos_breakdown_distance": 0.431,
        "pos_breakdown_clinch": 0.6,
        "pos_breakdown_ground": 0,
        "advances": 0,
        "advance_to_half_guard": 0,
        "advance_to_side": 0,
        "advance_to_mount": 0,
        "advance_to_back": 0,
        "reversals": 0,
        "submissions": 0,
        "slam_rate": 0,
        "time_in_control_seconds": 0
      },
      "elo": {
        "before": 1674,
        "after": 1658
      }
    },
    {
      "fighter_id": "4350812",
      "name": "Ilia Topuria",
      "stats": {
        "fighter_id": "4350812",
        "knock_downs": 1,
        "total_strikes_attempted": 78,
        "total_strikes_landed": 36,
        "sig_strikes_attempted": 77,
        "sig_strikes_landed": 35,
        "sig_distance_head_attempted": 50,
        "sig_distance_head_landed": 14,
        "sig_distance_body_attempted": 12,
        "sig_distance_body_landed": 8,
        "sig_distance_leg_attempted": 8,
        "sig_distance_leg_landed": 6,
        "sig_clinch_head_attempted": 0,
        "sig_clinch_head_landed": 0,
        "sig_clinch_body_attempted": 4,
        "sig_clinch_body_landed": 4,
        "sig_clinch_leg_attempted": 0,
        "sig_clinch_leg_landed": 0,
        "sig_ground_head_attempted": 3,
        "sig_ground_head_landed": 3,
        "sig_ground_body_attempted": 0,
        "sig_ground_body_landed": 0,
        "sig_ground_leg_attempted": 0,
        "sig_ground_leg_landed": 0,
        "takedowns_attempted": 0,
        "takedowns_landed": 0,
        "takedowns_slams": 0,
        "takedown_accuracy": 0,
        "target_breakdown_head": 0.321,
        "target_breakdown_body": 0.75,
        "target_breakdown_leg": 0.75,
        "pos_breakdown_distance": 0.4,
        "pos_breakdown_clinch": 1,
        "pos_breakdown_ground": 1,
        "advances": 0,
        "advance_to_half_guard": 0,
        "advance_to_side": 0,
        "advance_to_mount": 0,
        "advance_to_back": 0,
        "reversals": 0,
        "submissions": 0,
        "slam_rate": 0,
        "time_in_control_seconds": 3
      },
      "elo": {
        "before": 1625,
        "after": 1640
      }
    }
  ],
  "rounds": [
    {
      "fighter_id": "3949584",
      "fighter_name": "Alexander Volkanovski",
      "round": 1,
      "knock_downs": 0,
      "sig_landed": 26,
      "sig_attempted": 52,
      "total_landed": 26,
      "total_attempted": 52,
      "td_landed": 0,
      "td_attempted": 0,
      "sub_attempts": 0,
      "reversals": 0,
      "control_seconds": 0,
      "head_landed": 8,
      "head_attempted": 29,
      "body_landed": 7,
      "body_attempted": 12,
      "leg_landed": 11,
      "leg_attempted": 11,
      "distance_landed": 24,
      "distance_attempted": 49,
      "clinch_landed": 2,
      "clinch_attempted": 3,
      "ground_landed": 0,
      "ground_attempted": 0
    },
    {
      "fighter_id": "4350812",
      "fighter_name": "Ilia Topuria",
      "round": 1,
      "knock_downs": 0,
      "sig_landed": 15,
      "sig_attempted": 38,
      "total_landed": 16,
      "total_attempted": 39,
      "td_landed": 0,
      "td_attempted": 0,
      "sub_attempts": 0,
      "reversals": 0,
      "control_seconds": 0,
      "head_landed": 4,
      "head_attempted": 25,
      "body_landed": 7,
      "body_attempted": 8,
      "leg_landed": 4,
      "leg_attempted": 5,
      "distance_landed": 13,
      "distance_attempted": 36,
      "clinch_landed": 2,
      "clinch_attempted": 2,
      "ground_landed": 0,
      "ground_attempted": 0
    },
    {
      "fighter_id": "3949584",
      "fighter_name": "Alexander Volkanovski",
      "round": 2,
      "knock_downs": 0,
      "sig_landed": 21,
      "sig_attempted": 55,
      "total_landed": 21,
      "total_attempted": 55,
      "td_landed": 0,
      "td_attempted": 0,
      "sub_attempts": 0,
      "reversals": 0,
      "control_seconds": 0,
      "head_landed": 13,
      "head_attempted": 39,
      "body_landed": 4,
      "body_attempted": 10,
      "leg_landed": 4,
      "leg_attempted": 6,
      "distance_landed": 20,
      "distance_attempted": 53,
      "clinch_landed": 1,
      "clinch_attempted": 2,
      "ground_landed": 0,
      "ground_attempted": 0
    }
  ],
  "odds": [
    {
      "provider": "Bet365",
      "a_open": -170,
      "a_close": -130,
      "a_current": -130,
      "b_open": 140,
      "b_close": 110,
      "b_current": 110,
      "total_rounds": 3.5
    },
    {
      "provider": "BetfairSportsbook",
      "a_open": -188,
      "a_close": -138,
      "a_current": -138,
      "b_open": 150,
      "b_close": 110,
      "b_current": 110,
      "total_rounds": null
    },
    {
      "provider": "Caesars Sportsbook (CO)",
      "a_open": -175,
      "a_close": -135,
      "a_current": -135,
      "b_open": 150,
      "b_close": 115,
      "b_current": 115,
      "total_rounds": null
    }
  ]
}