Skip to main content

​
Promotion Endpoints (8)

All endpoints use base URL https://api.sportsapipro.com/v2/mma.

​
Promotion Info

​
Season-Specific Endpoints

All require tournamentId + seasonId. Discover season IDs via the /seasons endpoint.
Upcoming vs past cards — pick the right bucket.Each UFC / MMA card is its own “season”. Which endpoint to call depends on whether the card has been fought yet:
  • Upcoming card (announced, fight week, not yet contested) → GET /api/mma/tournament/:id/season/:sid/events/next/0 returns the full fight list (main card + prelims + early prelims).
  • Past card (fights already contested) → GET /api/mma/tournament/:id/season/:sid/events/last/0 returns the same fights with results attached.
  • Once fight night ends, fights migrate from next to last. If you want a single query that works either way, hit both and merge — one will be populated.
A 404 / empty response from one side simply means the card is on the other side of fight night; it is not a bug.

​
Example — upcoming UFC 329 card

Returns all 14 fights on the card, each with its own id, homeTeam / awayTeam (fighters), fightType (maincard / prelims / earlyprelims), weight class, venue, and Unix startTimestamp. Use GET /api/mma/match/:fightId for per-fight detail (odds, main-event flag, walkout timestamps).
Last modified on July 9, 2026