Skip to main content

Schedule API Documentation

Requirement

You need an API key to use OddsBlaze. Get access at www.oddsblaze.com.

Description​

This endpoint returns upcoming and live events.

API Endpoint​

https://schedule.oddsblaze.com/

Parameters​

key (required)​

Your OddsBlaze API key.

league (required)​

The league id (e.g. nfl).

id​

The event id (e.g. d0c5a5a4-ed06-5465-b21d-967b30c8e30c). Separate multiple ids with a comma (e.g. 693aca18-dd5c-5593-bd31-746fd8c65e9f,4c236889-5654-559b-8b16-134ca3bfd640).

team​

The away or home team id, name, or abbreviation (e.g. 99aa05e6-9f3d-5707-b342-aaa3accd992e, Chicago White Sox, or CHW). Separate multiple teams with a comma (e.g. Chicago White Sox,Seattle Mariners).

date​

The event date in PT (e.g. YYYY-MM-DD). Separate multiple dates with a comma (e.g. 2025-09-05,2025-09-07,2025-09-08). Separate date ranges with a hyphen (e.g. 2025-09-05-2025-09-08).

live​

Include only live events (true) or only pre-match events (false).

status​

The event status (e.g. Scheduled). Separate multiple status with a comma (e.g. In Progress,Final,Delayed).

Example URLs​

MLB schedule:

https://schedule.oddsblaze.com/?key=your_key&league=mlb

NFL schedule, month of September:

https://schedule.oddsblaze.com/?key=your_key&league=nfl&date=2026-09-01-2026-09-30

Example Response​

{
  "updated": "2026-05-20T20:43:04.531Z",
  "league": {
    "id": "mlb",
    "name": "MLB",
    "sport": "Baseball"
  },
  "events": [
    {
      "id": "d0c5a5a4-ed06-5465-b21d-967b30c8e30c",
      "mappings": {
        "MLB": {
          "id": "823134"
        },
        "Sofascore": {
          "id": "15503318"
        },
        "SportsDataIO": {
          "id": "10078022"
        }
      },
      "teams": {
        "away": {
          "id": "99aa05e6-9f3d-5707-b342-aaa3accd992e",
          "name": "Chicago White Sox",
          "abbreviation": "CHW"
        },
        "home": {
          "id": "1937570d-025f-5b6e-bc3a-883f44a9ebef",
          "name": "Seattle Mariners",
          "abbreviation": "SEA"
        }
      },
      "date": "2026-05-20T20:10:00.000Z",
      "live": true,
      "status": "In Progress",
      "scores": {
        "total": {
          "away": 0,
          "home": 1
        },
        "periods": {
          "1": {
            "away": 0,
            "home": 0
          },
          "2": {
            "away": 0,
            "home": 1
          }
        }
      },
      "period": 2,
      "inning": "Bot 2nd",
      "count": {
        "balls": 1,
        "strikes": 2,
        "outs": 1
      },
      "bases": [
        2
      ]
    }
  ]
}