Rankings

Official board (point-in-time)

The time machine: pass ?date=YYYY-MM-DD for the board as it stood on any date (UFC official back to 2013, 543 snapshots). A snapshot is valid until superseded. Rank 0 = champion; P4P has no rank 0.

Every entry carries movement against the previous snapshot of the same board (previous rank minus current rank: positive moved up, 0 held, null when not on the previous board) and is_new (true when there was a previous snapshot and the fighter was not ranked in that division on it), plus nationality and country_code (ISO-3166 alpha-2). Fighters are matched by division + name, so a fighter moving divisions reads as new. meta.previous_snapshot_date / meta.next_snapshot_date name the neighbouring snapshots (null at either end) — pass one as date to step through history.

get/v1/rankings/{org}

Request

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

Path parameters

org'ufc' | 'pfl' | 'oktagon' | 'bkfc' required

Query parameters

datestring date

A real calendar day; the snapshot in force on that date is returned.

board'official' | 'meta'

official for every org (for UFC that is the media-panel vote ufc.com publishes); UFC additionally has meta.

Default official (for UFC that is the media-panel vote ufc.com publishes). UFC additionally has meta.

Response

Board grouped by division

Changes

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