GuidesRelease Log
Coverage MatrixDocumentationChange LogLog InContact Us
Release Log

NCAA Football API – Team Colors in Roster Endpoint

We've added team colors to the Team Roster endpoint in our NCAA Football API.

Each color is provided as both a hex value and an RGB object primary and secondary).


Benefit

Team colors were previously available only in the League Hierarchy endpoint. You can now access a team's primary and secondary colors directly in the Team Roster endpoint.


📋 Recommended Actions

  • Read the new team_colors array from the Team Roster endpoint instead of making a separate League Hierarchy call.
  • Use the type field (primary / secondary) to select colors rather than relying on array order.
  • Apply the hex_color or rgb_color value that fits your rendering (e.g., hex for CSS, RGB for native styling).

☑️ Sample Requests:

Team Roster

curl --request GET \
     --url https://api.sportradar.com/ncaafb/trial/v7/en/teams/{team_id}/full_roster.json \
     --header 'accept: application/json' \
     --header 'x-api-key: YOUR_API_KEY'

🔢 Products

SportProductVersion(s)
American FootballNCAA Football APIv7

🔁 Endpoints Affected


⚙️ Return Samples

<team_colors>
    <team_color type="secondary" hex_color="#000000">
        <rgb_color red="0" green="0" blue="0"/>
    </team_color>
    <team_color type="primary" hex_color="#ffcd00">
        <rgb_color red="255" green="205" blue="0"/>
    </team_color>
</team_colors>
"team_colors": [
    {
        "type": "secondary",
        "hex_color": "#000000",
        "rgb_color": {
            "red": 0,
            "green": 0,
            "blue": 0
        }
    },
    {
        "type": "primary",
        "hex_color": "#ffcd00",
        "rgb_color": {
            "red": 255,
            "green": 205,
            "blue": 0
        }
    }
],