NCAA Football

Football Teams

Retrieve a list of supported football teams that are matched by multiple data providers.

Credit Consumption: 1 API call credits per request

Endpoint: GET /v2/sport/football/teams

RequestQuery Parameters:

• classification (string) - Filter by classification: fbs, fcs

Sample Request

curl -X GET "https://api-ai-oracle.apro.com/v2/sport/football/teams?classification=fbs" \
  -H "accept: application/json"

Sample Response

{
    "status": {
        "timestamp": 1742456976497,
        "code": 200,
        "message": ""
    },
    "data": {
        "total": 1,
        "teams": [
            {
                "canonical_id": "ALA",
                "canonical_name": "Alabama Crimson Tide",
                "abbreviation": "BAMA",
                "conference": "SEC",
                "classification": "fbs"
            }
        ],
        "signatures": [
            {
                "signer": "0x...",
                "hash": "0x...",
                "signature": "0x...",
                "timestamp": 1767493423377
            }
        ]
    }
}

Football Game

Retrieve live game information based on home and away team IDs.

Credit Consumption: 5 API call credits per request

Endpoint: GET /v2/sport/football/game

RequestQuery Parameters:

• home_team_id (string) - Home team canonical ID. Example: MISS

• away_team_id (string) - Away team canonical ID. Example: TULN

• date (string) - Date in YYYY-MM-DD format in America/New_York timezone. Example: 2025-12-21. If not provided, the current NY timezone date is used.

Sample Request

curl -X GET "https://api-ai-oracle.apro.com/v2/sport/football/game?home_team_id=MISS&away_team_id=TULN&date=2025-12-21" \
  -H "accept: application/json"

Sample Response

{
    "status": {
        "timestamp": 1742456976497,
        "code": 200,
        "message": ""
    },
    "data": {
        "game": {
            "date": {
                "timezone": "America/New_York",
                "timestamp": 1734825600
            },
            "venue": {
                "name": "Vaught-Hemingway Stadium"
            },
            "status": {
                "short": "FT",
                "long": "Final"
            },
            "completed": true,
            "league": {
                "name": "NCAA Football",
                "season": "2024",
                "country": "USA"
            },
            "teams": {
                "home": {
                    "id": "MISS",
                    "name": "Mississippi Rebels"
                },
                "away": {
                    "id": "TULN",
                    "name": "Tulane Green Wave"
                }
            },
            "scores": {
                "home": {
                    "quarter_1": 7,
                    "quarter_2": 14,
                    "quarter_3": 10,
                    "quarter_4": 7,
                    "total": 38
                },
                "away": {
                    "quarter_1": 3,
                    "quarter_2": 7,
                    "quarter_3": 0,
                    "quarter_4": 7,
                    "total": 17
                }
            }
        },
        "provider_games": [
            {
                "provider_name": "apisports",
                "game_info": { ... }
            },
            {
                "provider_name": "cfbd",
                "game_info": { ... }
            },
            {
                "provider_name": "sportradar",
                "game_info": { ... }
            }
        ],
        "signatures": [
            {
                "signer": "0x...",
                "hash": "0x...",
                "signature": "0x...",
                "timestamp": 1767493423377
            }
        ]
    }
}

Football Schedules

Retrieve game schedules based on the home team, away team, and date.

Credit Consumption: 1 API call credits per request

Endpoint: GET /v2/sport/football/schedules

RequestQuery Parameters:

• home_team_id (string) - Optional, Home team canonical ID. Example: MISS

• away_team_id (string) - Optional, Away team canonical ID. Example: TULN

• date (string) - Date in YYYY-MM-DD format in America/New_York timezone. Example: 2025-12-21. If not provided, the current NY timezone date is used.

Sample Request

curl -X GET "https://api-ai-oracle.apro.com/v2/sport/football/schedules?date=2025-12-23" \
  -H "accept: application/json"

Sample Response

{
    "status": {
        "timestamp": 1766563526635,
        "code": 200,
        "message": ""
    },
    "data": [
        {
            "season": "2025",
            "league": "NCAA",
            "game_date": "2025-12-23T14:00:00-05:00",
            "home_team_id": "LOU",
            "home_team_name": "Louisville",
            "away_team_id": "TOL",
            "away_team_name": "Toledo"
        },
        {
            "season": "2025",
            "league": "NCAA",
            "game_date": "2025-12-23T17:30:00-05:00",
            "home_team_id": "USM",
            "home_team_name": "Southern Miss",
            "away_team_id": "WKU",
            "away_team_name": "Western Kentucky"
        },
        {
            "season": "2025",
            "league": "NCAA",
            "game_date": "2025-12-23T21:00:00-05:00",
            "home_team_id": "OHIO",
            "home_team_name": "Ohio",
            "away_team_id": "UNLV",
            "away_team_name": "UNLV"
        }
    ]
}