Skip to content

get_event

2 creditsBasic lookupPOST /v1/get_event

A card's fights with results, method, round, time and judges' scores

Use it when you want one card's results in order: winner, method, round, time, judges' scores and referee for every fight.

Parameters

event_idstringrequired
Event id from list_events or get_schedule.

Notes

  • Over MCP, ask for it in plain English and the client calls get_event itself. Point any MCP client at https://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_event \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "event_id": "600039753"
}'

Response

json
{
  "event": {
    "event_id": "600039753",
    "name": "UFC 298: Volkanovski vs. Topuria",
    "short_name": "UFC 298",
    "starts_at": "2024-02-17T23:30:00.000Z",
    "event_date": "2024-02-17",
    "venue": "Honda Center",
    "city": "Anaheim",
    "country": "USA",
    "status": "final"
  },
  "bouts": [
    {
      "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"
    },
    {
      "bout_id": "401622060",
      "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": "Middleweight",
      "card_segment": "main",
      "match_number": 2,
      "title_fight": false,
      "scheduled_rounds": 3,
      "status": "final",
      "fighter_a": "3009717",
      "fighter_a_name": "Robert Whittaker",
      "fighter_b": "4080826",
      "fighter_b_name": "Paulo Costa",
      "winner": "3009717",
      "method": "decision---unanimous",
      "method_display": "Decision - Unanimous",
      "end_round": 3,
      "end_clock": "5:00",
      "duration_seconds": 900,
      "judges_scores": "29-28 | 29-28 | 30-27",
      "referee": "Mike Beltran"
    },
    {
      "bout_id": "401622064",
      "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": "Welterweight",
      "card_segment": "main",
      "match_number": 3,
      "title_fight": false,
      "scheduled_rounds": 3,
      "status": "final",
      "fighter_a": "3111997",
      "fighter_a_name": "Geoff Neal",
      "fighter_b": "4738092",
      "fighter_b_name": "Ian Machado Garry",
      "winner": "4738092",
      "method": "decision---split",
      "method_display": "Decision - Split",
      "end_round": 3,
      "end_clock": "5:00",
      "duration_seconds": 900,
      "judges_scores": "27-30 | 29-28 | 27-30",
      "referee": "Frank Trigg"
    }
  ],
  "count": 12
}

Response fields

eventobject
event.event_idstring
event.namestring
event.short_namestring
event.starts_atstring
event.event_datestring
event.venuestring
event.citystring
event.countrystring
event.statusstring
bouts[]array
List of objects
bouts[].bout_idstring
bouts[].event_idstring
bouts[].event_namestring
bouts[].event_datestring
bouts[].starts_atstring
bouts[].weight_classstring
bouts[].card_segmentstring
bouts[].match_numbernumber
bouts[].title_fightboolean
bouts[].scheduled_roundsnumber
bouts[].statusstring
bouts[].fighter_astring
bouts[].fighter_a_namestring
bouts[].fighter_bstring
bouts[].fighter_b_namestring
bouts[].winnerstring
bouts[].methodstring
bouts[].method_displaystring
bouts[].end_roundnumber
bouts[].end_clockstring
bouts[].duration_secondsnumber
bouts[].judges_scoresnull
bouts[].refereestring
countnumber

Related endpoints

Try it

500 credits free on signup: 250 calls to get_event, and no card.