Authentication

Send one backend API key header:

• Authorization: Bearer <api_key>
• X-API-Key: <api_key>

Gateway validation header:

• X-RapidAPI-Proxy-Secret: <shared_secret>

Query Parameters

• sex (required): m or f
• weight_class (required): e.g. lightweight, p4p
• organisation (optional): defaults to ufc
• date (optional): YYYY-MM-DD

Sample Request

curl "https://fightdx.com/api/rankings/?sex=m&weight_class=lightweight" \
  -H "X-RapidAPI-Proxy-Secret: your-shared-secret" \
  -H "X-API-Key: your-backend-api-key"

Sample Response (200)

{
  "organisation": {"id": "ufc", "display_name": "UFC"},
  "sex": "m",
  "weight_class": {"id": "lightweight", "display_name": "Lightweight"},
  "requested_date": null,
  "effective_date": "2025-01-20",
  "snapshot": {
    "date": "2025-01-20",
    "ranks": []
  }
}

Error Codes

• 401: Unauthorized (invalid or missing API key)
• 403: Forbidden (missing/invalid proxy secret or denied source)
• 404: Rankings data not found
• 429: Too Many Requests