Fights

Search completed bouts (filtered)

Completed bouts with a winner across the launch promotions, filtered — the one-call answer to "the last title fight to end by knockout" or "every submission win for this fighter". At least one narrowing filter is required (title_only, method, division, fighter, winner, from, to, main_events_only; org, order, limit and cursor do not count) — a bare call 400s filter_required, because the whole table is not sold as a list or a bulk export on any plan. Newest first by default (order=oldest reverses it); inside one card the main event comes first, then card order. Up to 25 rows per page and at most 10 pages deep (page_depth_exceeded past that — narrow the filters). Each row is the bout (same shape as /v1/fights/{id}) plus its event (id, slug, title, org, starts_at); meta.filters echoes the filters applied. fighter/winner take a slug or id (404 when not on the roster).

get/v1/fights/search

Request

  • Base URL: https://api.ufcalendar.com
  • URL: https://api.ufcalendar.com/v1/fights/search
  • Auth: HTTP bearer

Query parameters

org'ufc' | 'pfl' | 'oktagon' | 'bkfc' | 'rizin'

Launch org slug: ufc, pfl, oktagon, bkfc or rizin. Staged orgs 400 until promoted.

title_onlyboolean

true = title bouts only.

method'ko' | 'sub' | 'dec' | 'finish' | 'any'

ko = KO/TKO, sub = submission, dec = any decision, finish = KO/TKO or submission, any (default) = no method filter.

divisionstring

Division slug (lightweight, womens-strawweight, …) for an exact match, or a name fragment (≤40 characters) matched anywhere in the weight class.

fighterstring

Fighter slug or id — bouts this fighter was in, either corner.

winnerstring

Fighter slug or id — bouts this fighter won.

fromstring date

First UTC calendar day, inclusive YYYY-MM-DD, matched against the event's starts_at (first bell, UTC) — not the venue's local date. Must be a real calendar day.

tostring date

Last UTC calendar day, inclusive YYYY-MM-DD, matched against starts_at (UTC). An evening card in the Americas starts after midnight UTC, so it falls on the next UTC day: a Saturday-night Las Vegas card needs to= the Sunday. Must be a real calendar day.

main_events_onlyboolean

true = main events only.

order'newest' | 'oldest'
cursorstring

Opaque cursor from meta.pagination.next_cursor; an unreadable cursor restarts at the first page.

limitinteger

Response

Matching bouts

Example response

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

Changes

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