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

List MMA events

Fight cards (UFC) by date, with the main event and its result once known

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

Parameters

  • statusstring · query

    scheduled, live, finished or cancelled

  • date_fromstring · query

    Events on or after this date (YYYY-MM-DD)

  • date_tostring · query

    Events on or before this date (YYYY-MM-DD)

  • limitinteger · query

    Maximum results (1-100)

    Default: 50
  • offsetinteger · query

    Results to skip

    Default: 0

Response

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

  • dataarray of object
  • 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
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.
500INTERNAL_ERROROur side. Try again after a few seconds and check the status page.

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?