Docs/UFC API/UFC Fighters

UFC Fighters

Profiles, records, full pro careers (UFC and other promotions), career stats, and fight history

New

Full pro career (UFC and other promotions)

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

Every pro MMA fight we have for the fighter, in the UFC and outside it (regional promotions, Bellator, PFL, Contender Series, Road to UFC, TUF house fights), newest first, with the record split into UFC and outside-UFC. UFC fights carry boutId for /bouts/{id}. record.official is the UFC's published W-L-D; record.listed is counted from the fights in the list, and listedMatchesOfficial says whether they agree. TUF house fights are exhibitions (isExhibition) and count on the record only where the official record counts them. outsideUfcHistory is false when only UFC cards are on file for the fighter. RAF wrestling is a different sport and is served on /raf only.

Query parameters

ParameterTypeDescription
promotionstringOnly these promotion slugs, comma-separated (e.g. bellator,pfl). Records are not filtered.
excludeUfcbooleantrue drops UFC-card fights from the list (Contender Series and Road to UFC stay)
pagenumberPage number (default 1)
limitnumberPage size (default 100, max 500)

Example

bash
curl "https://api.citoapi.com/api/v1/ufc/fighters/arman-tsarukyan/career?excludeUfc=true" \
    -H "x-api-key: YOUR_API_KEY"

Response

json
{
    "success": true,
    "data": {
      "fighter": { "slug": "arman-tsarukyan", "name": "Arman Tsarukyan" },
      "record": {
        "official": { "wins": 24, "losses": 3, "draws": 0, "text": "24-3-0" },
        "listed": { "wins": 24, "losses": 3, "draws": 0, "noContests": 0, "text": "24-3-0" },
        "ufc": { "wins": 11, "losses": 2, "draws": 0, "noContests": 0, "text": "11-2-0" },
        "outsideUfc": { "wins": 13, "losses": 1, "draws": 0, "noContests": 0, "text": "13-1-0" },
        "listedMatchesOfficial": true
      },
      "outsideUfcHistory": true,
      "promotions": [
        { "slug": "ufc", "name": "Ultimate Fighting Championship", "fights": 13, "record": { "text": "11-2-0" } },
        { "slug": "mfp", "name": "MFP", "fights": 8, "record": { "text": "7-1-0" } }
      ],
      "fights": [
        {
          "date": "2018-08-22",
          "promotion": { "slug": "league-s-70", "name": "League S-70" },
          "onUfcRecord": false,
          "countsOnProRecord": true,
          "isExhibition": false,
          "event": { "name": "League S-70: Plotforma S-70: 2018", "slug": null },
          "boutId": null,
          "opponent": { "name": "Felipe Olivieri", "slug": null },
          "result": "W",
          "method": "KO/TKO",
          "methodGroup": "KO/TKO",
          "round": 3,
          "time": "1:25",
          "titleFight": false,
          "weightClass": null,
          "isUpcoming": false,
          "dataSource": "career_history"
        }
      ]
    },
    "meta": { "count": 14, "total": 14, "page": 1, "limit": 100, "hasMore": false }
  }

List fighters

GET/api/v1/ufc/fighters
GET/api/v1/ufc/athletes

/athletes is an alias of /fighters.

Query parameters

ParameterTypeDescription
pagenumberPage number (default 1)
limitnumberPage size (default 50)

Example

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

Search

GET/api/v1/ufc/search

Resolve a fighter slug (also returns events and bouts).

Query parameters

ParameterTypeDescription
q*stringSearch text

Example

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

Fighter profile

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

Bio, record, weight class, stance, height/reach, rankings, image.

Example

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

Response

json
{
  "success": true,
  "data": {
    "slug": "islam-makhachev",
    "name": "Islam Makhachev",
    "record": { "wins": 27, "losses": 1, "draws": 0 },
    "weightClass": "Lightweight",
    "stance": "Orthodox",
    "imageUrl": "https://..."
  }
}

Career stats

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

Striking and grappling accuracy, defense, win methods, strike targets.

Example

bash
curl "https://api.citoapi.com/api/v1/ufc/fighters/islam-makhachev/stats" \
  -H "x-api-key: YOUR_API_KEY"

Fight history

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

Past bouts with opponents, events, and results.

Example

bash
curl "https://api.citoapi.com/api/v1/ufc/fighters/islam-makhachev/fights" \
  -H "x-api-key: YOUR_API_KEY"

Ship fighter profiles

Cito is how you build UFC fighter profiles, fight cards, rankings pages, research tools, and MMA dashboards. Try these requests in the sandbox, then drop them into your app.

bash
curl "https://api.citoapi.com/api/v1/ufc/fighters/arman-tsarukyan/career" \
  -H "x-api-key: YOUR_API_KEY"

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

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

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

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