Skip to content
Get a key
API reference / Mma
GET/mma/events/{id}

Get an MMA event

A fight card with every bout from the main event down: weight class, fighters, winner, method, round, time, judges' scores and fight stats

In preview, not in plans yetPay per call without a key: $0.005 in USDC

Parameters

  • idinteger · pathrequired

    Event ID

Response

JSON with success, the result in data, and where the endpoint pages its results meta.

  • dataobject
  • attributionstring

    Attribution: set when a result shown comes from Wikipedia.

  • boutsinteger
  • cardarray of object
  • attributionstring
  • event_idinteger
  • fighter1object
  • fighter2object
  • idinteger
  • judges_scoresarray of string

    "29-28", one per judge

  • main_cardboolean
  • main_eventboolean
  • methodstring
  • method_detailstring

    Punches, Rear Naked Choke

  • orderinteger
  • result_sourcestring

    ResultSource: the data provider, or wikipedia where the result (winner, method, round, time, scores) is the event article's: the data provider had none, it was changed after the event (overturned), or the data provider does not list the bout. Attribution is set then.

  • roundinteger

    the round it ended in

  • startstring

    UTC

  • statsarray of integer

    fighter1, fighter2: strikes by target (total, power), knockdowns, takedowns, submissions, control time

  • statusstring

    scheduled, live, finished, cancelled, postponed

  • timestring

    time in that round, "4:07"

  • updated_atstring
  • weight_classstring
  • winnerinteger
  • datestring

    the event's (US) date

  • idinteger
  • main_eventobject
  • attributionstring
  • event_idinteger
  • fighter1object
  • fighter2object
  • idinteger
  • judges_scoresarray of string

    "29-28", one per judge

  • main_cardboolean
  • main_eventboolean
  • methodstring
  • method_detailstring

    Punches, Rear Naked Choke

  • orderinteger
  • result_sourcestring

    ResultSource: the data provider, or wikipedia where the result (winner, method, round, time, scores) is the event article's: the data provider had none, it was changed after the event (overturned), or the data provider does not list the bout. Attribution is set then.

  • roundinteger

    the round it ended in

  • startstring

    UTC

  • statsarray of integer

    fighter1, fighter2: strikes by target (total, power), knockdowns, takedowns, submissions, control time

  • statusstring

    scheduled, live, finished, cancelled, postponed

  • timestring

    time in that round, "4:07"

  • updated_atstring
  • weight_classstring
  • winnerinteger
  • namestring
  • statusstring
  • errorobject
  • codestring
  • messagestring
  • metaobject
  • attributionstring

    Attribution a data source's licence asks for (Cricsheet's history).

  • limitinteger
  • offsetinteger
  • totalinteger
  • successboolean

Errors

StatusCodeWhen
400INVALID_PARAMA parameter is missing or wrong, and the message names it. Fix the request; do not retry it.
401UNAUTHORIZEDThe key is missing, mistyped or was rotated.
402x402 offersNo key and no valid payment: the body lists what to pay. Only a 200 answer is charged.
404NOT_FOUNDNo record with that id.

All errors have the shape described in Errors and limits.

Generated from the OpenAPI file, version 1.0. See it as JSON

Was this page helpful?