SportsDataIO · Schema
Timeframe
Sports DataStatisticsLive ScoresFantasy SportsOddsNFLNBAMLBNHLSoccer
Properties
| Name | Type | Description |
|---|---|---|
| SeasonType | integer | The season type of the timeframe (1=Regular Season, 2=Preseason, 3=Postseason, 4=Offseason, 5=All-Star) |
| Season | integer | The league year of the timeframe (this gets incremented on the first day of the league year during free agency) |
| Week | integernull | The week of the timeframe (regular season: 1 to 18; preseason: 0 to 4; postseason: 1 to4; offseason=NULL). Note: seasons after 2021 will have only 3 preseason weeks |
| Name | stringnull | The friendly name of the Timeframe |
| ShortName | stringnull | The shorter name of the Timeframe |
| StartDate | stringnull | The start date/time of this Timeframe |
| EndDate | stringnull | The end date and time of the timeframe |
| FirstGameStart | stringnull | The start date/time of the first game of the Timeframe (if no games then returns the StartDate) |
| FirstGameEnd | stringnull | The end date/time of the first game of the Timeframe (if no games then returns the EndDate) |
| LastGameEnd | stringnull | The end date/time of the last game of the Timeframe (if no games then returns the EndDate) |
| HasGames | boolean | Whether there are any games in this Timeframe |
| HasStarted | boolean | Whether this Timeframe has started |
| HasEnded | boolean | Whether this Timeframe has ended |
| HasFirstGameStarted | boolean | Whether the first game has started |
| HasFirstGameEnded | boolean | Whether the first game has ended |
| HasLastGameEnded | boolean | Whether the last game has ended |
| ApiSeason | stringnull | The value of the Season parameter used to pass into the API |
| ApiWeek | stringnull | The value of the Week parameter used to pass into the API |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "#/components/schemas/Timeframe",
"title": "Timeframe",
"properties": {
"SeasonType": {
"type": "integer",
"description": "The season type of the timeframe (1=Regular Season, 2=Preseason, 3=Postseason, 4=Offseason, 5=All-Star)"
},
"Season": {
"type": "integer",
"description": "The league year of the timeframe (this gets incremented on the first day of the league year during free agency)"
},
"Week": {
"type": [
"integer",
"null"
],
"description": "The week of the timeframe (regular season: 1 to 18; preseason: 0 to 4; postseason: 1 to4; offseason=NULL). Note: seasons after 2021 will have only 3 preseason weeks"
},
"Name": {
"type": [
"string",
"null"
],
"description": "The friendly name of the Timeframe"
},
"ShortName": {
"type": [
"string",
"null"
],
"description": "The shorter name of the Timeframe"
},
"StartDate": {
"type": [
"string",
"null"
],
"description": "The start date/time of this Timeframe"
},
"EndDate": {
"type": [
"string",
"null"
],
"description": "The end date and time of the timeframe"
},
"FirstGameStart": {
"type": [
"string",
"null"
],
"description": "The start date/time of the first game of the Timeframe (if no games then returns the StartDate)"
},
"FirstGameEnd": {
"type": [
"string",
"null"
],
"description": "The end date/time of the first game of the Timeframe (if no games then returns the EndDate)"
},
"LastGameEnd": {
"type": [
"string",
"null"
],
"description": "The end date/time of the last game of the Timeframe (if no games then returns the EndDate)"
},
"HasGames": {
"type": "boolean",
"description": "Whether there are any games in this Timeframe"
},
"HasStarted": {
"type": "boolean",
"description": "Whether this Timeframe has started"
},
"HasEnded": {
"type": "boolean",
"description": "Whether this Timeframe has ended"
},
"HasFirstGameStarted": {
"type": "boolean",
"description": "Whether the first game has started"
},
"HasFirstGameEnded": {
"type": "boolean",
"description": "Whether the first game has ended"
},
"HasLastGameEnded": {
"type": "boolean",
"description": "Whether the last game has ended"
},
"ApiSeason": {
"type": [
"string",
"null"
],
"description": "The value of the Season parameter used to pass into the API"
},
"ApiWeek": {
"type": [
"string",
"null"
],
"description": "The value of the Week parameter used to pass into the API"
}
}
}
Work with this as data
Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/sportsdataio-timeframe"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.