UFC API

Fighter profiles, rankings, event cards, live fight-night state, bout results, and deep round-by-round statistics for MMA applications and research.

BASEhttps://api.citoapi.com/api/v1

UFC API RootAppend any endpoint path below.

New

Full fighter careers, not just UFC fights

/ufc/fighters/{slug}/career returns every pro MMA fight we have for a fighter: UFC cards plus Bellator, PFL, regional promotions, Contender Series, Road to UFC and TUF. Each fight carries the promotion, opponent, result, method and round, and the record is split into UFC and outside-UFC next to the official record. Arman Tsarukyan, for example: 24-3-0, of which 13-1 came before the UFC.

GET /api/v1/ufc/fighters/arman-tsarukyan/careerCareer docs

New

Road to UFC and the MMA archives

Road to UFC is on the same endpoints as the Contender Series: all 5 seasons (2022 to 2026), 19 cards and 166 fights, every one with official round-by-round stats, on slugs like road-to-ufc-2-7. At Road to UFC 2.7, Rongzhu landed 64 of 121 significant strikes and submitted Shin Haraguchi at 3:06 of round 3. The Bellator archive (2014 to 2024, official round-by-round stats for Bellator 131 to 172) is on /bellator, the PFL (every card since 2018, live fight status, results only) is on /pfl, and PRIDE, Strikeforce, WEC, DREAM, EliteXC and Affliction are on their own routes, with /mma across all of them. Fighters with a UFC record keep their UFC slug, the stat rows use the same format as /ufc, and all of it comes with any UFC plan.

GET /api/v1/ufc/events/road-to-ufc-2-7/statsMMA archive docs

UFC Live — REST, SSE, and WebSockets available now

Poll /ufc/live and /ufc/live/{boutId} every ~1–2s for fight clocks, bout status, and live stats when available. SSE push is at /ufc/live/stream. Room-based WebSockets are live at wss://…/ufc/live/ws.

GET /api/v1/ufc/liveUFC Live docs

What UFC data is available?

Fighter profiles, records, weight classes, rankings, stance, height, reach, and profile stats

Meta UFC Rankings (official algorithmic) and media-panel rankings as separate endpoints

Upcoming, recent, and historical event cards with clean IDs and pagination

Live fight-night clocks, bout state, lag metadata, and SSE push (WebSockets on paid plan soon)

Bout results: winner, method, finish round, finish time, referee, weight class, and scheduled rounds

Fight totals: knockdowns, significant strikes, total strikes, takedowns, submission attempts, reversals, and control time

Round stats: per-fighter rows by round with head/body/leg and distance/clinch/ground splits

Fighter stat charts: striking accuracy, takedown accuracy, defense, win by method, significant strikes by target, and position

Betting odds: moneyline, totals, method of victory, round props, bookmaker filters (including live prediction-market prices), and data-quality metadata

Live fight night

Use /ufc/live and bout detail for clocks, live status, and SSE push. WebSockets on paid plan soon.

Fight cards

Use events, event detail, and event bouts for upcoming and completed card pages.

Fighter profiles

Use fighter profile, stats, fights, and rankings endpoints for profile screens.

Round stats

Use bout stats and round filters for detailed fight analytics and research tools.

Odds screens

Use event and fight odds for market boards, sportsbook comparison, betting research, and model inputs.

No-friction workflow

Rather be told than poll? UFC webhooks send a signed POST at each bell, result and official stat line.

6 steps to fight cards, odds, and stat rows

1List events

GET /ufc/events?hasStats=true&page=1&limit=50

2Open the card

GET /ufc/events/{eventIdOrSlug}

3Get all fights

GET /ufc/events/{eventIdOrSlug}/bouts

4Load card odds

GET /ufc/events/{eventIdOrSlug}/odds?bookmaker=all

5Fetch card stats

GET /ufc/events/{eventIdOrSlug}/stats

6Filter one fight

GET /ufc/fights/{boutId}/odds?bookmaker=draftkings

Start here for card pages, fighter profiles, or deep round analytics. All endpoints return clean JSON with stable IDs.

Endpoints

UFC coverage paths for live fight night, fighter profiles, event cards, rankings, bout stats, and betting odds. Full live + WebSocket guide →

GET/api/v1/ufc

UfcCoverage overview, data groups, and sync metadata.

Bash

curl "https://api.citoapi.com/api/v1/ufc" \
  -H "x-api-key: YOUR_API_KEY"

GET/api/v1/ufc/search?q=islam

SearchSearch fighters, events, bouts, and divisions.

Bash

curl "https://api.citoapi.com/api/v1/ufc/search?q=islam" \
  -H "x-api-key: YOUR_API_KEY"

GET/api/v1/ufc/live

Live OverviewLive card overview: active bouts, clocks, lagSeconds, recommendedPollSeconds.

Bash

curl "https://api.citoapi.com/api/v1/ufc/live" \
  -H "x-api-key: YOUR_API_KEY"

GET/api/v1/ufc/live/events

Live EventsSupervisor state for fight-night events tracked by the live worker.

Bash

curl "https://api.citoapi.com/api/v1/ufc/live/events" \
  -H "x-api-key: YOUR_API_KEY"

GET/api/v1/ufc/live/{boutId}

Live BoutOne live bout by ufc-{id} or bare numeric id (clock, fighters, stats).

Bash

curl "https://api.citoapi.com/api/v1/ufc/live/{boutId}" \
  -H "x-api-key: YOUR_API_KEY"

GET/api/v1/ufc/live/{boutId}/state

Live Bout StateCompact live state for polling clients.

Bash

curl "https://api.citoapi.com/api/v1/ufc/live/{boutId}/state" \
  -H "x-api-key: YOUR_API_KEY"

GET/api/v1/ufc/live/stream

Live SSE StreamSSE push feed (filter with boutId and/or eventSlug).

Bash

curl "https://api.citoapi.com/api/v1/ufc/live/stream" \
  -H "x-api-key: YOUR_API_KEY"

GET/api/v1/ufc/live/health

Live HealthLive worker health and heartbeat lag.

Bash

curl "https://api.citoapi.com/api/v1/ufc/live/health" \
  -H "x-api-key: YOUR_API_KEY"

GET/api/v1/ufc/rankings

RankingsOfficial Meta UFC Rankings grouped by division (algorithmic).

Bash

curl "https://api.citoapi.com/api/v1/ufc/rankings" \
  -H "x-api-key: YOUR_API_KEY"

GET/api/v1/ufc/rankings/meta

MetaExplicit Meta UFC Rankings endpoint (same data as /rankings).

Bash

curl "https://api.citoapi.com/api/v1/ufc/rankings/meta" \
  -H "x-api-key: YOUR_API_KEY"

GET/api/v1/ufc/rankings/meta/{division}

DivisionMeta rankings for one division, such as lightweight.

Bash

curl "https://api.citoapi.com/api/v1/ufc/rankings/meta/{division}" \
  -H "x-api-key: YOUR_API_KEY"

GET/api/v1/ufc/rankings/media

MediaTraditional media-panel rankings grouped by division.

Bash

curl "https://api.citoapi.com/api/v1/ufc/rankings/media" \
  -H "x-api-key: YOUR_API_KEY"

GET/api/v1/ufc/rankings/media/{division}

DivisionMedia-panel rankings for one division.

Bash

curl "https://api.citoapi.com/api/v1/ufc/rankings/media/{division}" \
  -H "x-api-key: YOUR_API_KEY"

GET/api/v1/ufc/rankings/{division}

DivisionMeta rankings for one division (alias of /rankings/meta/{division}).

Bash

curl "https://api.citoapi.com/api/v1/ufc/rankings/{division}" \
  -H "x-api-key: YOUR_API_KEY"

GET/api/v1/ufc/fighters?page=1&limit=50

List FightersPaginated fighter directory with profile metadata and stat availability.

Bash

curl "https://api.citoapi.com/api/v1/ufc/fighters?page=1&limit=50" \
  -H "x-api-key: YOUR_API_KEY"

GET/api/v1/ufc/fighters/{slug}

SlugFighter profile, bio, record, rankings, and stat summary.

Bash

curl "https://api.citoapi.com/api/v1/ufc/fighters/{slug}" \
  -H "x-api-key: YOUR_API_KEY"

GET/api/v1/ufc/fighters/{slug}/stats

Slug StatsStriking, grappling, accuracy, defense, win method, target, and position stats.

Bash

curl "https://api.citoapi.com/api/v1/ufc/fighters/{slug}/stats" \
  -H "x-api-key: YOUR_API_KEY"

GET/api/v1/ufc/fighters/{slug}/fights

FightsFight history for one fighter.

Bash

curl "https://api.citoapi.com/api/v1/ufc/fighters/{slug}/fights" \
  -H "x-api-key: YOUR_API_KEY"

GET/api/v1/ufc/fighters/{slug}/career

CareerFull pro MMA career: UFC fights plus every other promotion, with UFC and outside-UFC records.

Bash

curl "https://api.citoapi.com/api/v1/ufc/fighters/{slug}/career" \
  -H "x-api-key: YOUR_API_KEY"

GET/api/v1/ufc/fighters/{slug}/style

StyleStyle profile: striker, clinch, wrestler and submission scores from official round stats (UFC plus MMA archives), with position, target and absorbed numbers and a tentative pressure/outfighter tag.

Bash

curl "https://api.citoapi.com/api/v1/ufc/fighters/{slug}/style" \
  -H "x-api-key: YOUR_API_KEY"

GET/api/v1/ufc/athletes

AthletesAlias for /fighters.

Bash

curl "https://api.citoapi.com/api/v1/ufc/athletes" \
  -H "x-api-key: YOUR_API_KEY"

GET/api/v1/ufc/athletes/{slug}

SlugAlias for /fighters/{slug}.

Bash

curl "https://api.citoapi.com/api/v1/ufc/athletes/{slug}" \
  -H "x-api-key: YOUR_API_KEY"

GET/api/v1/ufc/events?hasStats=true&page=1&limit=50

List EventsPaginated events, optionally filtered to cards with fight stats.

Bash

curl "https://api.citoapi.com/api/v1/ufc/events?hasStats=true&page=1&limit=50" \
  -H "x-api-key: YOUR_API_KEY"

GET/api/v1/ufc/events/recent

Recent MatchesRecently completed UFC events.

Bash

curl "https://api.citoapi.com/api/v1/ufc/events/recent" \
  -H "x-api-key: YOUR_API_KEY"

GET/api/v1/ufc/events/upcoming

Upcoming ScheduleUpcoming UFC fight cards.

Bash

curl "https://api.citoapi.com/api/v1/ufc/events/upcoming" \
  -H "x-api-key: YOUR_API_KEY"

GET/api/v1/ufc/events/{eventIdOrSlug}

EventIdOrSlugEvent detail by clean slug or stable data ID.

Bash

curl "https://api.citoapi.com/api/v1/ufc/events/{eventIdOrSlug}" \
  -H "x-api-key: YOUR_API_KEY"

GET/api/v1/ufc/events/{eventIdOrSlug}/bouts

Event BoutsAll bouts on an event card.

Bash

curl "https://api.citoapi.com/api/v1/ufc/events/{eventIdOrSlug}/bouts" \
  -H "x-api-key: YOUR_API_KEY"

GET/api/v1/ufc/events/{eventIdOrSlug}/stats?round=1

EventIdOrSlug StatsFight stats for an event, filtered by round when needed.

Bash

curl "https://api.citoapi.com/api/v1/ufc/events/{eventIdOrSlug}/stats?round=1" \
  -H "x-api-key: YOUR_API_KEY"

GET/api/v1/ufc/events/{eventIdOrSlug}/odds?bookmaker=all

EventIdOrSlug OddsAll available odds for one UFC card, grouped by fight, market, bookmaker, and outcome.

Bash

curl "https://api.citoapi.com/api/v1/ufc/events/{eventIdOrSlug}/odds?bookmaker=all" \
  -H "x-api-key: YOUR_API_KEY"

GET/api/v1/ufc/fight-cards/{eventIdOrSlug}/odds?bookmaker=draftkings

EventIdOrSlug OddsAlias for event odds using the fight-card route family.

Bash

curl "https://api.citoapi.com/api/v1/ufc/fight-cards/{eventIdOrSlug}/odds?bookmaker=draftkings" \
  -H "x-api-key: YOUR_API_KEY"

GET/api/v1/ufc/bouts?hasStats=true&includeStats=true

Event BoutsPaginated bout list with optional stat rows.

Bash

curl "https://api.citoapi.com/api/v1/ufc/bouts?hasStats=true&includeStats=true" \
  -H "x-api-key: YOUR_API_KEY"

GET/api/v1/ufc/bouts/{boutId}

BoutIdOne bout with fighters, result, method, round, time, and event context.

Bash

curl "https://api.citoapi.com/api/v1/ufc/bouts/{boutId}" \
  -H "x-api-key: YOUR_API_KEY"

GET/api/v1/ufc/fights/{boutId}/odds?bookmaker=draftkings

BoutId OddsOdds for one fight, filterable by sportsbook or bookmaker group.

Bash

curl "https://api.citoapi.com/api/v1/ufc/fights/{boutId}/odds?bookmaker=draftkings" \
  -H "x-api-key: YOUR_API_KEY"

GET/api/v1/ufc/fights/{boutId}/odds?bookmaker=prediction_market

BoutId OddsPrediction-market odds for one fight, live during the fight (refreshed every 20 seconds while the card is on).

Bash

curl "https://api.citoapi.com/api/v1/ufc/fights/{boutId}/odds?bookmaker=prediction_market" \
  -H "x-api-key: YOUR_API_KEY"

GET/api/v1/ufc/events/{eventIdOrSlug}/odds?bookmaker=prediction_market

EventIdOrSlug OddsPrediction-market odds for every fight on a card, live during the card.

Bash

curl "https://api.citoapi.com/api/v1/ufc/events/{eventIdOrSlug}/odds?bookmaker=prediction_market" \
  -H "x-api-key: YOUR_API_KEY"

GET/api/v1/ufc/bouts/{boutId}/odds?bookmaker=all

BoutId OddsAlias for fight odds using the bout route family.

Bash

curl "https://api.citoapi.com/api/v1/ufc/bouts/{boutId}/odds?bookmaker=all" \
  -H "x-api-key: YOUR_API_KEY"

GET/api/v1/ufc/bouts/{boutId}/stats?round=1

BoutId StatsBout-level fighter stat totals or one selected round.

Bash

curl "https://api.citoapi.com/api/v1/ufc/bouts/{boutId}/stats?round=1" \
  -H "x-api-key: YOUR_API_KEY"

GET/api/v1/ufc/bouts/{boutId}/rounds?round=2

Bout RoundsRound-by-round fighter stat rows for one bout.

Bash

curl "https://api.citoapi.com/api/v1/ufc/bouts/{boutId}/rounds?round=2" \
  -H "x-api-key: YOUR_API_KEY"

GET/api/v1/ufc/sync/status

StatusLatest UFC sync run status and coverage counters.

Bash

curl "https://api.citoapi.com/api/v1/ufc/sync/status" \
  -H "x-api-key: YOUR_API_KEY"

Odds endpoints

Event odds

GET /api/v1/ufc/events/{eventIdOrSlug}/odds

Use this for full card odds pages, market boards, sportsbook comparison tables, and model inputs that need every fight on one event.

Fight odds

GET /api/v1/ufc/fights/{boutId}/odds

Use this for one-fight matchup pages, odds widgets, prop cards, and bookmaker-specific views tied to a bout ID.

Prediction-market live odds

GET /api/v1/ufc/fights/{boutId}/odds?bookmaker=prediction_marketGET /api/v1/ufc/events/{eventIdOrSlug}/odds?bookmaker=prediction_market

Prediction-market prices for each fight: moneyline, rounds over/under, goes the distance and method. These markets keep trading while a fight is on, so during a card these refresh every 20 seconds and the fight in progress has isLive: true. Add available=true for only the prices open right now. Field reference

Filters and aliases

bookmaker=all returns every available sportsbook.
bookmaker=draftkings, fanduel, or betonline narrows the response.
bookmaker=prediction_market returns prediction-market prices, refreshed every 20 seconds during a live card (how they work).
/ufc/fight-cards/{slug}/odds aliases event odds.
/ufc/bouts/{boutId}/odds aliases fight odds.

Market types

moneylinefight_totalmethod_of_victoryexact_roundround_methodround_groupfight_goes_distancefinish_only_moneylinedraw

Round stats example

curl "https://api.citoapi.com/api/v1/ufc/bouts/770c5302e32916ea/stats?round=1" \
  -H "x-api-key: YOUR_API_KEY"

Append ?round=1, ?round=2, or ?round=3 to pull a single round of per-fighter stats instead of the full bout totals.

Start with a free key

Test UFC endpoints with 500 free requests/month. Scale up for production fight cards, profiles, or stat dashboards.

Start Free Explore UFC API

Was this page helpful?