NBA Season Schedule API Documentation

Requirement

You need an API key to use SportsBlaze. Get access at www.sportsblaze.com.

Update Frequency

This endpoint updates every 60 seconds.

Description

This endpoint returns NBA schedules by season.

API Endpoint

https://api.sportsblaze.com/nba/v1/schedule/season/{season}.json

Parameters

key (required)

Your SportsBlaze API key.

type

The season type (e.g. Regular Season or Playoffs). Separate multiple types with a comma (e.g. Preseason,Play-In Tournament,In-Season Tournament).

id

The game id (e.g. cdd0b2e7-7a06-5d09-b0a9-7d3169e53a5f). Separate multiple ids with a comma (e.g. cdd0b2e7-7a06-5d09-b0a9-7d3169e53a5f,d9af5bc6-153f-5154-a4c1-c7759acb804b).

team

The away or home team(s) id or name (e.g. fa62a1a5-2e7d-541f-8e96-e52b64f25a07 or Los Angeles Lakers). Separate multiple teams with a comma (e.g. Los Angeles Lakers,Houston Rockets).

status

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

Example URLs

2024 season schedule:

https://api.sportsblaze.com/nba/v1/schedule/season/2024.json?key=your_key

Example Response

{
    "league": {
        "id": "nba",
        "name": "NBA",
        "sport": "Basketball"
    },
    "games": [
        {
            "season": {
                "year": 2024,
                "type": "Regular Season"
            },
            "id": "cdd0b2e7-7a06-5d09-b0a9-7d3169e53a5f",
            "teams": {
                "away": {
                    "id": "0d08bf4d-cd46-5bb3-b9fb-9ae5a8f07f6e",
                    "name": "Houston Rockets"
                },
                "home": {
                    "id": "fa62a1a5-2e7d-541f-8e96-e52b64f25a07",
                    "name": "Los Angeles Lakers"
                }
            },
            "date": "2025-04-11T22:30:00Z",
            "status": "Final",
            "venue": {
                "name": "Crypto.com Arena",
                "location": "Los Angeles, CA"
            },
            "scores": {
                "periods": [
                    {
                        "number": 1,
                        "type": "Regulation",
                        "away": {
                            "points": 32
                        },
                        "home": {
                            "points": 38
                        }
                    },
                    {
                        "number": 2,
                        "type": "Regulation",
                        "away": {
                            "points": 24
                        },
                        "home": {
                            "points": 40
                        }
                    },
                    {
                        "number": 3,
                        "type": "Regulation",
                        "away": {
                            "points": 31
                        },
                        "home": {
                            "points": 29
                        }
                    },
                    {
                        "number": 4,
                        "type": "Regulation",
                        "away": {
                            "points": 22
                        },
                        "home": {
                            "points": 33
                        }
                    }
                ],
                "total": {
                    "away": {
                        "points": 109
                    },
                    "home": {
                        "points": 140
                    }
                }
            }
        }
    ],
    "updated": "2025-04-16T21:04:00Z"
}