Public docs assistant

Tell Cito API what you are building.

Get endpoint recommendations, exact requests, code snippets, and a free-key CTA without digging through every page.

Docs/API Reference/UFC API

UFC API

Fighters, rankings, events, fight cards, bout stats, and round-by-round MMA stat rows.

Base URL

https://api.citoapi.com/api/v1/ufc

What UFC data is available?

Fighter profiles, records, weight classes, rankings, stance, height, reach, and profile stats
UFC rankings by division, including champions and ranked contenders where available
Upcoming, recent, and historical event cards with clean IDs and pagination
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

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.

No-friction workflow

1

List events

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

Open the card

GET /ufc/events/{eventIdOrSlug}
3

Get all fights

GET /ufc/events/{eventIdOrSlug}/bouts
4

Fetch card stats

GET /ufc/events/{eventIdOrSlug}/stats
5

Filter one round

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

Endpoints

GET/api/v1/ufc

Coverage overview, data groups, and sync metadata.

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

Search fighters, events, bouts, and divisions.

GET/api/v1/ufc/rankings

Current UFC rankings grouped by division.

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

Rankings for one division, such as lightweight or welterweight.

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

Paginated fighter directory with profile metadata and stat availability.

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

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

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

Striking, grappling, accuracy, defense, win method, target, and position stats.

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

Fight history for one fighter.

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

Paginated events, optionally filtered to cards with fight stats.

GET/api/v1/ufc/events/recent

Recently completed UFC events.

GET/api/v1/ufc/events/upcoming

Upcoming UFC fight cards.

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

Event detail by clean slug or stable data ID.

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

All bouts on an event card.

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

Fight stats for an event, filtered by round when needed.

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

Paginated bout list with optional stat rows.

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

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

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

Bout-level fighter stat totals or one selected round.

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

Round-by-round fighter stat rows for one bout.

Round stats example

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

Use ?round=1, ?round=2, or ?round=3 when your app needs one round instead of the full fight.

Start with a free key

Test UFC endpoints with 500 free requests/month, then upgrade when your fight card, fighter profile, or analytics tool needs more volume.

Start FreeView UFC API page