Events

Event with full card

Full fight card (both corners, results when completed), venue and event-scoped broadcast rows. Every event and card entry carries sport (e.g. mma, bare-knuckle-boxing). Renamed events 308-redirect from stale slugs.

Card order is read over non-cancelled bouts only. ordering runs headliner-first (1 = main event), and ordering, card_section and is_main describe the card as it stands — except on a status: "cancelled" entry, which keeps the slot and section it had when it was scratched. The promotion re-lays the card around it afterwards, so a cancelled entry can share an ordering with a live bout or sit in a section that no longer matches its neighbours. Filter status != "cancelled" before deriving running order or sections.

include=eta adds eta (ISO timestamp or null) to every card entry: the estimated start of that bout, by the same rule the website's event page uses. These are estimates, not a schedule — each card section anchors on its declared start, and every completed bout re-anchors the rest of its section on its real finish. Cancelled bouts get null.

include=odds adds odds to every card entry: the current UFCalendar consensus line (a, b, favourite, fair_probability_a, sources, recorded_at), or null when the bout is unpriced. Information only, not betting advice; the opening/closing lines and movement are on /v1/events/{idOrSlug}/odds.

get/v1/events/{idOrSlug}

Request

  • Base URL: https://api.ufcalendar.com
  • URL: https://api.ufcalendar.com/v1/events/{idOrSlug}
  • Auth: HTTP bearer

Path parameters

idOrSlugstring required

Numeric id or slug of the event. Stale slugs 308-redirect to the canonical URL.

Query parameters

include'eta' | 'odds'

eta = per-bout estimated start times (estimates, not a schedule; re-anchored on each completed bout). odds = each card entry gains odds, the current UFCalendar consensus line (OddsPair, or null when unpriced; one extra query for the whole card). Comma-separate to ask for both (eta,odds). Unknown values 400 invalid_include.

Response

Event detail

Example response

{
  "data": {
    "sport": "mma",
    "card": [
      {
        "sport": "mma"
      }
    ]
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.