LineupAPI Documentation V2
Get started with LineupAPI
Subscribe to plan via email
Get your API key from dashboard
See the demo, start building!
Host
All requests use the host https://api.lineupapi.com/v2/
Example URL: https://api.lineupapi.com/v2/fixtures?apiKey={apiKey}
Available leagues
LineupAPI currently supports these 5 leagues:
- Premier League (England)
- La Liga (Spain)
- Serie A (Italy)
- Bundesliga (Germany)
- Ligue 1 (France)
GET fixtures
Returns the newest list of upcoming fixtures in the 17 days forecast window.
Each fixture includes its unique fixtureId. This ID is required in other endpoints such as /predictions and history/* routes.
URL
GET https://api.lineupapi.com/v2/fixtures/?apiKey={apiKey}
Inputs
Example
URL https://api.lineupapi.com/v2/fixtures/?apiKey=YOUR_API_KEY
Try it in the browser
No data.
Extra headers
You’ll receive these headers in the response:
- x-credits-cost: The usage credit cost of this API call
- x-credits-used: Credits used since the last reset
- x-credits-remaining: Credits remaining until the next reset
Cost
Calling this URL costs 1 usage credit.
GET players
Returns the latest player reference database accumulated from all players used in predictions.
Each entry includes a playerId, which is referenced across all prediction responses.
URL
GET https://api.lineupapi.com/v2/players/?apiKey={apiKey}
Inputs
Example
URL https://api.lineupapi.com/v2/players/?apiKey=YOUR_API_KEY
Try it in the browser
No data.
Extra headers
You’ll receive these headers in the response:
- x-credits-cost: The usage credit cost of this API call
- x-credits-used: Credits used since the last reset
- x-credits-remaining: Credits remaining until the next reset
Cost
Calling this URL costs 10 usage credits.
GET predictions
Returns the most recent prediction snapshot for a fixture.
Use the groups query parameter to select one or more prediction groups (comma-separated).
The request cost scales with the number of unique groups requested. Available groups:
- lineups — starter / benchAndPlay / notPlay probabilities (%)
- minutes — minutes-played bucket probabilities (%)
- cards — yellow / red / no card probabilities (%)
- goals — goal threshold probabilities (%)
- assists — assist threshold probabilities (%)
- corners_taken — corners taken threshold probabilities (%)
- fouls_won — fouls won threshold probabilities (%)
- fouls_conceded — fouls conceded threshold probabilities (%)
URL
GET https://api.lineupapi.com/v2/predictions/{fixtureId}/?apiKey={apiKey}&groups={groups}
Inputs
fixtureId: The unique ID of the fixture you want predictions for, in UUID format (e.g.
f61793bf-59e8-4d1b-81bd-458a1fd138dd).
Get valid fixture IDs from/fixtures(field:fixtureId). Use this same ID across prediction and history endpoints.groups: Select which prediction groups to include in the response.
Possible values arelineups,minutes,goals,assists,cards,corners_taken,fouls_won,fouls_conceded.
Provide as a comma-separated list (e.g.groups=lineups,goals,cards).
If you includeallas any group value, the API returns all available groups.apiKey: Your subscription API key. Find it in your dashboard or choose a plan.
Example
URL https://api.lineupapi.com/v2/predictions/f61793bf-59e8-4d1b-81bd-458a1fd138dd/?groups=all&apiKey=YOUR_API_KEY
Try it in the browser
No data.
Extra headers
You’ll receive these headers in the response:
- x-credits-cost: The usage credit cost of this API call
- x-credits-used: Credits used since the last reset
- x-credits-remaining: Credits remaining until the next reset
Cost
The usage quota cost depends on the number of prediction groups in the request.cost = 1 x [number of unique groups]
GET predictions metadata
Return all the available prediction metadata files for a specific fixture, including information about the models used.
This is useful to discover what prediction content exists, how it was created, and at which exact time.
URL
GET https://api.lineupapi.com/v2/predictions/metadata/{fixtureId}/?apiKey={apiKey}
Inputs
fixtureId: The unique ID of the fixture you want predictions for, in UUID format (e.g.
f61793bf-59e8-4d1b-81bd-458a1fd138dd).
Get valid fixture IDs from/fixtures(field:fixtureId). Use this same ID across prediction and history endpoints.apiKey: Your subscription API key. Find it in your dashboard or choose a plan.
Example
URL https://api.lineupapi.com/v2/predictions/metadata/?apiKey=YOUR_API_KEY
Try it in the browser
https://api.lineupapi.com/v2/predictions/metadata/?apiKey=YOUR_API_KEY
{
"fixtureId": ["f61793bf-59e8-4d1b-81bd-458a1fd138dd"],
"count": [17],
"items": [
{
"key": "predictions/metadata/f61793bf-59e8-4d1b-81bd-458a1fd138dd/2025-04-24T14-15-00Z.json",
"timestamp": "2025-04-24T14:15:00Z",
"data": {
"fixture": {
"id": ["f61793bf-59e8-4d1b-81bd-458a1fd138dd"],
"commence_time": ["2025-05-11T14:15:00Z"]
},
"snapshot": {
"snapshot_time": ["2025-04-24T14:15:00Z"],
"created_at": ["2025-04-24T14:15:25Z"]
},
"prediction": {
"forecast_days": [17],
"forecast_reliability": ["LOW"]
},
"model": {
"lineups": {
"model_applied": ["385981f2-2712-43f5-9549-7a9e8ce7344a", "a33235eb-7f2f-49a3-a96c-683c99cf019a"],
"model_version": ["1.10", "1.11"],
"training_samples": [76938, 241529],
"date_last_sample": ["2025-04-13", "2025-04-13"]
},
"minutes": {
"model_applied": ["abb0a259-4835-4807-a204-85b825726e41"],
"model_version": ["1.10"],
"training_samples": [84271],
"date_last_sample": ["2025-04-13"]
},
"goals": {
"model_applied": ["ee71e429-088a-4632-8c02-92ad12c64483"],
"model_version": ["1.10"],
"training_samples": [84271],
"date_last_sample": ["2025-04-13"]
},
"assists": {
"model_applied": ["c77d25ad-573d-46f4-8a4f-26855c2b3eae"],
"model_version": ["1.10"],
"training_samples": [84271],
"date_last_sample": ["2025-04-13"]
},
"cards": {
"model_applied": ["2417bb5b-a9be-446b-8c41-690e92ba5636"],
"model_version": ["1.10"],
"training_samples": [84271],
"date_last_sample": ["2025-04-13"]
},
"corners_taken": {
"model_applied": ["5710404d-7e64-42b8-bca2-b17716c3612a"],
"model_version": ["1.11"],
"training_samples": [84271],
"date_last_sample": ["2025-04-13"]
},
"fouls_won": {
"model_applied": ["655d0819-13ce-4263-ac0f-447af55b8a7d"],
"model_version": ["1.11"],
"training_samples": [84271],
"date_last_sample": ["2025-04-13"]
},
"fouls_conceded": {
"model_applied": ["99ffbdd3-e574-42d1-84c4-8f5f3c820bf8"],
"model_version": ["1.11"],
"training_samples": [84271],
"date_last_sample": ["2025-04-13"]
}
}
}
},
{
"key": "predictions/metadata/f61793bf-59e8-4d1b-81bd-458a1fd138dd/2025-04-25T14-15-00Z.json",
"timestamp": "2025-04-25T14:15:00Z",
"data": {
"fixture": {
"id": ["f61793bf-59e8-4d1b-81bd-458a1fd138dd"],
"commence_time": ["2025-05-11T14:15:00Z"]
},
"snapshot": {
"snapshot_time": ["2025-04-25T14:15:00Z"],
"created_at": ["2025-04-25T14:15:20Z"]
},
"prediction": {
"forecast_days": [16],
"forecast_reliability": ["LOW"]
},
"model": {
"lineups": {
"model_applied": ["385981f2-2712-43f5-9549-7a9e8ce7344a", "a33235eb-7f2f-49a3-a96c-683c99cf019a"],
"model_version": ["1.10", "1.11"],
"training_samples": [76938, 241529],
"date_last_sample": ["2025-04-13", "2025-04-13"]
},
"minutes": {
"model_applied": ["abb0a259-4835-4807-a204-85b825726e41"],
"model_version": ["1.10"],
"training_samples": [84271],
"date_last_sample": ["2025-04-13"]
},
"goals": {
"model_applied": ["ee71e429-088a-4632-8c02-92ad12c64483"],
"model_version": ["1.10"],
"training_samples": [84271],
"date_last_sample": ["2025-04-13"]
},
"assists": {
"model_applied": ["c77d25ad-573d-46f4-8a4f-26855c2b3eae"],
"model_version": ["1.10"],
"training_samples": [84271],
"date_last_sample": ["2025-04-13"]
},
"cards": {
"model_applied": ["2417bb5b-a9be-446b-8c41-690e92ba5636"],
"model_version": ["1.10"],
"training_samples": [84271],
"date_last_sample": ["2025-04-13"]
},
"corners_taken": {
"model_applied": ["5710404d-7e64-42b8-bca2-b17716c3612a"],
"model_version": ["1.11"],
"training_samples": [84271],
"date_last_sample": ["2025-04-13"]
},
"fouls_won": {
"model_applied": ["655d0819-13ce-4263-ac0f-447af55b8a7d"],
"model_version": ["1.11"],
"training_samples": [84271],
"date_last_sample": ["2025-04-13"]
},
"fouls_conceded": {
"model_applied": ["99ffbdd3-e574-42d1-84c4-8f5f3c820bf8"],
"model_version": ["1.11"],
"training_samples": [84271],
"date_last_sample": ["2025-04-13"]
}
}
}
},
{
"key": "predictions/metadata/f61793bf-59e8-4d1b-81bd-458a1fd138dd/2025-04-26T14-15-00Z.json",
"timestamp": "2025-04-26T14:15:00Z",
"data": {
"fixture": {
"id": ["f61793bf-59e8-4d1b-81bd-458a1fd138dd"],
"commence_time": ["2025-05-11T14:15:00Z"]
},
"snapshot": {
"snapshot_time": ["2025-04-26T14:15:00Z"],
"created_at": ["2025-04-26T14:15:20Z"]
},
"prediction": {
"forecast_days": [15],
"forecast_reliability": ["LOW"]
},
"model": {
"lineups": {
"model_applied": ["385981f2-2712-43f5-9549-7a9e8ce7344a", "a33235eb-7f2f-49a3-a96c-683c99cf019a"],
"model_version": ["1.10", "1.11"],
"training_samples": [76938, 241529],
"date_last_sample": ["2025-04-13", "2025-04-13"]
},
"minutes": {
"model_applied": ["abb0a259-4835-4807-a204-85b825726e41"],
"model_version": ["1.10"],
"training_samples": [84271],
"date_last_sample": ["2025-04-13"]
},
"goals": {
"model_applied": ["ee71e429-088a-4632-8c02-92ad12c64483"],
"model_version": ["1.10"],
"training_samples": [84271],
"date_last_sample": ["2025-04-13"]
},
"assists": {
"model_applied": ["c77d25ad-573d-46f4-8a4f-26855c2b3eae"],
"model_version": ["1.10"],
"training_samples": [84271],
"date_last_sample": ["2025-04-13"]
},
"cards": {
"model_applied": ["2417bb5b-a9be-446b-8c41-690e92ba5636"],
"model_version": ["1.10"],
"training_samples": [84271],
"date_last_sample": ["2025-04-13"]
},
"corners_taken": {
"model_applied": ["5710404d-7e64-42b8-bca2-b17716c3612a"],
"model_version": ["1.11"],
"training_samples": [84271],
"date_last_sample": ["2025-04-13"]
},
"fouls_won": {
"model_applied": ["655d0819-13ce-4263-ac0f-447af55b8a7d"],
"model_version": ["1.11"],
"training_samples": [84271],
"date_last_sample": ["2025-04-13"]
},
"fouls_conceded": {
"model_applied": ["99ffbdd3-e574-42d1-84c4-8f5f3c820bf8"],
"model_version": ["1.11"],
"training_samples": [84271],
"date_last_sample": ["2025-04-13"]
}
}
}
},
{
"key": "predictions/metadata/f61793bf-59e8-4d1b-81bd-458a1fd138dd/2025-04-27T14-15-00Z.json",
"timestamp": "2025-04-27T14:15:00Z",
"data": {
"fixture": {
"id": ["f61793bf-59e8-4d1b-81bd-458a1fd138dd"],
"commence_time": ["2025-05-11T14:15:00Z"]
},
"snapshot": {
"snapshot_time": ["2025-04-27T14:15:00Z"],
"created_at": ["2025-04-27T14:15:20Z"]
},
"prediction": {
"forecast_days": [14],
"forecast_reliability": ["LOW"]
},
"model": {
"lineups": {
"model_applied": ["385981f2-2712-43f5-9549-7a9e8ce7344a", "a33235eb-7f2f-49a3-a96c-683c99cf019a"],
"model_version": ["1.10", "1.11"],
"training_samples": [76938, 241529],
"date_last_sample": ["2025-04-13", "2025-04-13"]
},
"minutes": {
"model_applied": ["abb0a259-4835-4807-a204-85b825726e41"],
"model_version": ["1.10"],
"training_samples": [84271],
"date_last_sample": ["2025-04-13"]
},
"goals": {
"model_applied": ["ee71e429-088a-4632-8c02-92ad12c64483"],
"model_version": ["1.10"],
"training_samples": [84271],
"date_last_sample": ["2025-04-13"]
},
"assists": {
"model_applied": ["c77d25ad-573d-46f4-8a4f-26855c2b3eae"],
"model_version": ["1.10"],
"training_samples": [84271],
"date_last_sample": ["2025-04-13"]
},
"cards": {
"model_applied": ["2417bb5b-a9be-446b-8c41-690e92ba5636"],
"model_version": ["1.10"],
"training_samples": [84271],
"date_last_sample": ["2025-04-13"]
},
"corners_taken": {
"model_applied": ["5710404d-7e64-42b8-bca2-b17716c3612a"],
"model_version": ["1.11"],
"training_samples": [84271],
"date_last_sample": ["2025-04-13"]
},
"fouls_won": {
"model_applied": ["655d0819-13ce-4263-ac0f-447af55b8a7d"],
"model_version": ["1.11"],
"training_samples": [84271],
"date_last_sample": ["2025-04-13"]
},
"fouls_conceded": {
"model_applied": ["99ffbdd3-e574-42d1-84c4-8f5f3c820bf8"],
"model_version": ["1.11"],
"training_samples": [84271],
"date_last_sample": ["2025-04-13"]
}
}
}
},
{
"key": "predictions/metadata/f61793bf-59e8-4d1b-81bd-458a1fd138dd/2025-04-28T14-15-00Z.json",
"timestamp": "2025-04-28T14:15:00Z",
"data": {
"fixture": {
"id": ["f61793bf-59e8-4d1b-81bd-458a1fd138dd"],
"commence_time": ["2025-05-11T14:15:00Z"]
},
"snapshot": {
"snapshot_time": ["2025-04-28T14:15:00Z"],
"created_at": ["2025-04-28T14:15:19Z"]
},
"prediction": {
"forecast_days": [13],
"forecast_reliability": ["LOW"]
},
"model": {
"lineups": {
"model_applied": ["385981f2-2712-43f5-9549-7a9e8ce7344a", "a33235eb-7f2f-49a3-a96c-683c99cf019a"],
"model_version": ["1.10", "1.11"],
"training_samples": [82785, 248010],
"date_last_sample": ["2025-04-27", "2025-04-27"]
},
"minutes": {
"model_applied": ["abb0a259-4835-4807-a204-85b825726e41"],
"model_version": ["1.10"],
"training_samples": [86427],
"date_last_sample": ["2025-04-27"]
},
"goals": {
"model_applied": ["ee71e429-088a-4632-8c02-92ad12c64483"],
"model_version": ["1.10"],
"training_samples": [86427],
"date_last_sample": ["2025-04-27"]
},
"assists": {
"model_applied": ["c77d25ad-573d-46f4-8a4f-26855c2b3eae"],
"model_version": ["1.10"],
"training_samples": [86427],
"date_last_sample": ["2025-04-27"]
},
"cards": {
"model_applied": ["2417bb5b-a9be-446b-8c41-690e92ba5636"],
"model_version": ["1.10"],
"training_samples": [86427],
"date_last_sample": ["2025-04-27"]
},
"corners_taken": {
"model_applied": ["5710404d-7e64-42b8-bca2-b17716c3612a"],
"model_version": ["1.11"],
"training_samples": [86427],
"date_last_sample": ["2025-04-27"]
},
"fouls_won": {
"model_applied": ["655d0819-13ce-4263-ac0f-447af55b8a7d"],
"model_version": ["1.11"],
"training_samples": [86427],
"date_last_sample": ["2025-04-27"]
},
"fouls_conceded": {
"model_applied": ["99ffbdd3-e574-42d1-84c4-8f5f3c820bf8"],
"model_version": ["1.11"],
"training_samples": [86427],
"date_last_sample": ["2025-04-27"]
}
}
}
},
{
"key": "predictions/metadata/f61793bf-59e8-4d1b-81bd-458a1fd138dd/2025-04-29T14-15-00Z.json",
"timestamp": "2025-04-29T14:15:00Z",
"data": {
"fixture": {
"id": ["f61793bf-59e8-4d1b-81bd-458a1fd138dd"],
"commence_time": ["2025-05-11T14:15:00Z"]
},
"snapshot": {
"snapshot_time": ["2025-04-29T14:15:00Z"],
"created_at": ["2025-04-29T14:15:21Z"]
},
"prediction": {
"forecast_days": [12],
"forecast_reliability": ["LOW"]
},
"model": {
"lineups": {
"model_applied": ["385981f2-2712-43f5-9549-7a9e8ce7344a", "a33235eb-7f2f-49a3-a96c-683c99cf019a"],
"model_version": ["1.10", "1.11"],
"training_samples": [82785, 248010],
"date_last_sample": ["2025-04-27", "2025-04-27"]
},
"minutes": {
"model_applied": ["abb0a259-4835-4807-a204-85b825726e41"],
"model_version": ["1.10"],
"training_samples": [86427],
"date_last_sample": ["2025-04-27"]
},
"goals": {
"model_applied": ["ee71e429-088a-4632-8c02-92ad12c64483"],
"model_version": ["1.10"],
"training_samples": [86427],
"date_last_sample": ["2025-04-27"]
},
"assists": {
"model_applied": ["c77d25ad-573d-46f4-8a4f-26855c2b3eae"],
"model_version": ["1.10"],
"training_samples": [86427],
"date_last_sample": ["2025-04-27"]
},
"cards": {
"model_applied": ["2417bb5b-a9be-446b-8c41-690e92ba5636"],
"model_version": ["1.10"],
"training_samples": [86427],
"date_last_sample": ["2025-04-27"]
},
"corners_taken": {
"model_applied": ["5710404d-7e64-42b8-bca2-b17716c3612a"],
"model_version": ["1.11"],
"training_samples": [86427],
"date_last_sample": ["2025-04-27"]
},
"fouls_won": {
"model_applied": ["655d0819-13ce-4263-ac0f-447af55b8a7d"],
"model_version": ["1.11"],
"training_samples": [86427],
"date_last_sample": ["2025-04-27"]
},
"fouls_conceded": {
"model_applied": ["99ffbdd3-e574-42d1-84c4-8f5f3c820bf8"],
"model_version": ["1.11"],
"training_samples": [86427],
"date_last_sample": ["2025-04-27"]
}
}
}
},
{
"key": "predictions/metadata/f61793bf-59e8-4d1b-81bd-458a1fd138dd/2025-04-30T14-15-00Z.json",
"timestamp": "2025-04-30T14:15:00Z",
"data": {
"fixture": {
"id": ["f61793bf-59e8-4d1b-81bd-458a1fd138dd"],
"commence_time": ["2025-05-11T14:15:00Z"]
},
"snapshot": {
"snapshot_time": ["2025-04-30T14:15:00Z"],
"created_at": ["2025-04-30T14:15:23Z"]
},
"prediction": {
"forecast_days": [11],
"forecast_reliability": ["LOW"]
},
"model": {
"lineups": {
"model_applied": ["385981f2-2712-43f5-9549-7a9e8ce7344a", "a33235eb-7f2f-49a3-a96c-683c99cf019a"],
"model_version": ["1.10", "1.11"],
"training_samples": [82785, 248010],
"date_last_sample": ["2025-04-27", "2025-04-27"]
},
"minutes": {
"model_applied": ["abb0a259-4835-4807-a204-85b825726e41"],
"model_version": ["1.10"],
"training_samples": [86427],
"date_last_sample": ["2025-04-27"]
},
"goals": {
"model_applied": ["ee71e429-088a-4632-8c02-92ad12c64483"],
"model_version": ["1.10"],
"training_samples": [86427],
"date_last_sample": ["2025-04-27"]
},
"assists": {
"model_applied": ["c77d25ad-573d-46f4-8a4f-26855c2b3eae"],
"model_version": ["1.10"],
"training_samples": [86427],
"date_last_sample": ["2025-04-27"]
},
"cards": {
"model_applied": ["2417bb5b-a9be-446b-8c41-690e92ba5636"],
"model_version": ["1.10"],
"training_samples": [86427],
"date_last_sample": ["2025-04-27"]
},
"corners_taken": {
"model_applied": ["5710404d-7e64-42b8-bca2-b17716c3612a"],
"model_version": ["1.11"],
"training_samples": [86427],
"date_last_sample": ["2025-04-27"]
},
"fouls_won": {
"model_applied": ["655d0819-13ce-4263-ac0f-447af55b8a7d"],
"model_version": ["1.11"],
"training_samples": [86427],
"date_last_sample": ["2025-04-27"]
},
"fouls_conceded": {
"model_applied": ["99ffbdd3-e574-42d1-84c4-8f5f3c820bf8"],
"model_version": ["1.11"],
"training_samples": [86427],
"date_last_sample": ["2025-04-27"]
}
}
}
},
{
"key": "predictions/metadata/f61793bf-59e8-4d1b-81bd-458a1fd138dd/2025-05-01T14-15-00Z.json",
"timestamp": "2025-05-01T14:15:00Z",
"data": {
"fixture": {
"id": ["f61793bf-59e8-4d1b-81bd-458a1fd138dd"],
"commence_time": ["2025-05-11T14:15:00Z"]
},
"snapshot": {
"snapshot_time": ["2025-05-01T14:15:00Z"],
"created_at": ["2025-05-01T14:15:23Z"]
},
"prediction": {
"forecast_days": [10],
"forecast_reliability": ["LOW"]
},
"model": {
"lineups": {
"model_applied": ["385981f2-2712-43f5-9549-7a9e8ce7344a", "a33235eb-7f2f-49a3-a96c-683c99cf019a"],
"model_version": ["1.10", "1.11"],
"training_samples": [82785, 248010],
"date_last_sample": ["2025-04-27", "2025-04-27"]
},
"minutes": {
"model_applied": ["abb0a259-4835-4807-a204-85b825726e41"],
"model_version": ["1.10"],
"training_samples": [86427],
"date_last_sample": ["2025-04-27"]
},
"goals": {
"model_applied": ["ee71e429-088a-4632-8c02-92ad12c64483"],
"model_version": ["1.10"],
"training_samples": [86427],
"date_last_sample": ["2025-04-27"]
},
"assists": {
"model_applied": ["c77d25ad-573d-46f4-8a4f-26855c2b3eae"],
"model_version": ["1.10"],
"training_samples": [86427],
"date_last_sample": ["2025-04-27"]
},
"cards": {
"model_applied": ["2417bb5b-a9be-446b-8c41-690e92ba5636"],
"model_version": ["1.10"],
"training_samples": [86427],
"date_last_sample": ["2025-04-27"]
},
"corners_taken": {
"model_applied": ["5710404d-7e64-42b8-bca2-b17716c3612a"],
"model_version": ["1.11"],
"training_samples": [86427],
"date_last_sample": ["2025-04-27"]
},
"fouls_won": {
"model_applied": ["655d0819-13ce-4263-ac0f-447af55b8a7d"],
"model_version": ["1.11"],
"training_samples": [86427],
"date_last_sample": ["2025-04-27"]
},
"fouls_conceded": {
"model_applied": ["99ffbdd3-e574-42d1-84c4-8f5f3c820bf8"],
"model_version": ["1.11"],
"training_samples": [86427],
"date_last_sample": ["2025-04-27"]
}
}
}
},
{
"key": "predictions/metadata/f61793bf-59e8-4d1b-81bd-458a1fd138dd/2025-05-02T14-15-00Z.json",
"timestamp": "2025-05-02T14:15:00Z",
"data": {
"fixture": {
"id": ["f61793bf-59e8-4d1b-81bd-458a1fd138dd"],
"commence_time": ["2025-05-11T14:15:00Z"]
},
"snapshot": {
"snapshot_time": ["2025-05-02T14:15:00Z"],
"created_at": ["2025-05-02T14:15:24Z"]
},
"prediction": {
"forecast_days": [9],
"forecast_reliability": ["LOW"]
},
"model": {
"lineups": {
"model_applied": ["385981f2-2712-43f5-9549-7a9e8ce7344a", "a33235eb-7f2f-49a3-a96c-683c99cf019a"],
"model_version": ["1.10", "1.11"],
"training_samples": [82785, 248010],
"date_last_sample": ["2025-04-27", "2025-04-27"]
},
"minutes": {
"model_applied": ["abb0a259-4835-4807-a204-85b825726e41"],
"model_version": ["1.10"],
"training_samples": [86427],
"date_last_sample": ["2025-04-27"]
},
"goals": {
"model_applied": ["ee71e429-088a-4632-8c02-92ad12c64483"],
"model_version": ["1.10"],
"training_samples": [86427],
"date_last_sample": ["2025-04-27"]
},
"assists": {
"model_applied": ["c77d25ad-573d-46f4-8a4f-26855c2b3eae"],
"model_version": ["1.10"],
"training_samples": [86427],
"date_last_sample": ["2025-04-27"]
},
"cards": {
"model_applied": ["2417bb5b-a9be-446b-8c41-690e92ba5636"],
"model_version": ["1.10"],
"training_samples": [86427],
"date_last_sample": ["2025-04-27"]
},
"corners_taken": {
"model_applied": ["5710404d-7e64-42b8-bca2-b17716c3612a"],
"model_version": ["1.11"],
"training_samples": [86427],
"date_last_sample": ["2025-04-27"]
},
"fouls_won": {
"model_applied": ["655d0819-13ce-4263-ac0f-447af55b8a7d"],
"model_version": ["1.11"],
"training_samples": [86427],
"date_last_sample": ["2025-04-27"]
},
"fouls_conceded": {
"model_applied": ["99ffbdd3-e574-42d1-84c4-8f5f3c820bf8"],
"model_version": ["1.11"],
"training_samples": [86427],
"date_last_sample": ["2025-04-27"]
}
}
}
},
{
"key": "predictions/metadata/f61793bf-59e8-4d1b-81bd-458a1fd138dd/2025-05-03T14-15-00Z.json",
"timestamp": "2025-05-03T14:15:00Z",
"data": {
"fixture": {
"id": ["f61793bf-59e8-4d1b-81bd-458a1fd138dd"],
"commence_time": ["2025-05-11T14:15:00Z"]
},
"snapshot": {
"snapshot_time": ["2025-05-03T14:15:00Z"],
"created_at": ["2025-05-03T14:15:23Z"]
},
"prediction": {
"forecast_days": [8],
"forecast_reliability": ["LOW"]
},
"model": {
"lineups": {
"model_applied": ["385981f2-2712-43f5-9549-7a9e8ce7344a", "a33235eb-7f2f-49a3-a96c-683c99cf019a"],
"model_version": ["1.10", "1.11"],
"training_samples": [82785, 248010],
"date_last_sample": ["2025-04-27", "2025-04-27"]
},
"minutes": {
"model_applied": ["abb0a259-4835-4807-a204-85b825726e41"],
"model_version": ["1.10"],
"training_samples": [86427],
"date_last_sample": ["2025-04-27"]
},
"goals": {
"model_applied": ["ee71e429-088a-4632-8c02-92ad12c64483"],
"model_version": ["1.10"],
"training_samples": [86427],
"date_last_sample": ["2025-04-27"]
},
"assists": {
"model_applied": ["c77d25ad-573d-46f4-8a4f-26855c2b3eae"],
"model_version": ["1.10"],
"training_samples": [86427],
"date_last_sample": ["2025-04-27"]
},
"cards": {
"model_applied": ["2417bb5b-a9be-446b-8c41-690e92ba5636"],
"model_version": ["1.10"],
"training_samples": [86427],
"date_last_sample": ["2025-04-27"]
},
"corners_taken": {
"model_applied": ["5710404d-7e64-42b8-bca2-b17716c3612a"],
"model_version": ["1.11"],
"training_samples": [86427],
"date_last_sample": ["2025-04-27"]
},
"fouls_won": {
"model_applied": ["655d0819-13ce-4263-ac0f-447af55b8a7d"],
"model_version": ["1.11"],
"training_samples": [86427],
"date_last_sample": ["2025-04-27"]
},
"fouls_conceded": {
"model_applied": ["99ffbdd3-e574-42d1-84c4-8f5f3c820bf8"],
"model_version": ["1.11"],
"training_samples": [86427],
"date_last_sample": ["2025-04-27"]
}
}
}
},
{
"key": "predictions/metadata/f61793bf-59e8-4d1b-81bd-458a1fd138dd/2025-05-04T14-15-00Z.json",
"timestamp": "2025-05-04T14:15:00Z",
"data": {
"fixture": {
"id": ["f61793bf-59e8-4d1b-81bd-458a1fd138dd"],
"commence_time": ["2025-05-11T14:15:00Z"]
},
"snapshot": {
"snapshot_time": ["2025-05-04T14:15:00Z"],
"created_at": ["2025-05-04T14:15:20Z"]
},
"prediction": {
"forecast_days": [7],
"forecast_reliability": ["LOW"]
},
"model": {
"lineups": {
"model_applied": ["385981f2-2712-43f5-9549-7a9e8ce7344a", "a33235eb-7f2f-49a3-a96c-683c99cf019a"],
"model_version": ["1.10", "1.11"],
"training_samples": [82785, 248010],
"date_last_sample": ["2025-04-27", "2025-04-27"]
},
"minutes": {
"model_applied": ["abb0a259-4835-4807-a204-85b825726e41"],
"model_version": ["1.10"],
"training_samples": [86427],
"date_last_sample": ["2025-04-27"]
},
"goals": {
"model_applied": ["ee71e429-088a-4632-8c02-92ad12c64483"],
"model_version": ["1.10"],
"training_samples": [86427],
"date_last_sample": ["2025-04-27"]
},
"assists": {
"model_applied": ["c77d25ad-573d-46f4-8a4f-26855c2b3eae"],
"model_version": ["1.10"],
"training_samples": [86427],
"date_last_sample": ["2025-04-27"]
},
"cards": {
"model_applied": ["2417bb5b-a9be-446b-8c41-690e92ba5636"],
"model_version": ["1.10"],
"training_samples": [86427],
"date_last_sample": ["2025-04-27"]
},
"corners_taken": {
"model_applied": ["5710404d-7e64-42b8-bca2-b17716c3612a"],
"model_version": ["1.11"],
"training_samples": [86427],
"date_last_sample": ["2025-04-27"]
},
"fouls_won": {
"model_applied": ["655d0819-13ce-4263-ac0f-447af55b8a7d"],
"model_version": ["1.11"],
"training_samples": [86427],
"date_last_sample": ["2025-04-27"]
},
"fouls_conceded": {
"model_applied": ["99ffbdd3-e574-42d1-84c4-8f5f3c820bf8"],
"model_version": ["1.11"],
"training_samples": [86427],
"date_last_sample": ["2025-04-27"]
}
}
}
},
{
"key": "predictions/metadata/f61793bf-59e8-4d1b-81bd-458a1fd138dd/2025-05-05T14-15-00Z.json",
"timestamp": "2025-05-05T14:15:00Z",
"data": {
"fixture": {
"id": ["f61793bf-59e8-4d1b-81bd-458a1fd138dd"],
"commence_time": ["2025-05-11T14:15:00Z"]
},
"snapshot": {
"snapshot_time": ["2025-05-05T14:15:00Z"],
"created_at": ["2025-05-05T14:15:20Z"]
},
"prediction": {
"forecast_days": [6],
"forecast_reliability": ["LOW"]
},
"model": {
"lineups": {
"model_applied": ["385981f2-2712-43f5-9549-7a9e8ce7344a", "a33235eb-7f2f-49a3-a96c-683c99cf019a"],
"model_version": ["1.10", "1.11"],
"training_samples": [82785, 248010],
"date_last_sample": ["2025-04-27", "2025-04-27"]
},
"minutes": {
"model_applied": ["abb0a259-4835-4807-a204-85b825726e41"],
"model_version": ["1.10"],
"training_samples": [86427],
"date_last_sample": ["2025-04-27"]
},
"goals": {
"model_applied": ["ee71e429-088a-4632-8c02-92ad12c64483"],
"model_version": ["1.10"],
"training_samples": [86427],
"date_last_sample": ["2025-04-27"]
},
"assists": {
"model_applied": ["c77d25ad-573d-46f4-8a4f-26855c2b3eae"],
"model_version": ["1.10"],
"training_samples": [86427],
"date_last_sample": ["2025-04-27"]
},
"cards": {
"model_applied": ["2417bb5b-a9be-446b-8c41-690e92ba5636"],
"model_version": ["1.10"],
"training_samples": [86427],
"date_last_sample": ["2025-04-27"]
},
"corners_taken": {
"model_applied": ["5710404d-7e64-42b8-bca2-b17716c3612a"],
"model_version": ["1.11"],
"training_samples": [86427],
"date_last_sample": ["2025-04-27"]
},
"fouls_won": {
"model_applied": ["655d0819-13ce-4263-ac0f-447af55b8a7d"],
"model_version": ["1.11"],
"training_samples": [86427],
"date_last_sample": ["2025-04-27"]
},
"fouls_conceded": {
"model_applied": ["99ffbdd3-e574-42d1-84c4-8f5f3c820bf8"],
"model_version": ["1.11"],
"training_samples": [86427],
"date_last_sample": ["2025-04-27"]
}
}
}
},
{
"key": "predictions/metadata/f61793bf-59e8-4d1b-81bd-458a1fd138dd/2025-05-06T14-15-00Z.json",
"timestamp": "2025-05-06T14:15:00Z",
"data": {
"fixture": {
"id": ["f61793bf-59e8-4d1b-81bd-458a1fd138dd"],
"commence_time": ["2025-05-11T14:15:00Z"]
},
"snapshot": {
"snapshot_time": ["2025-05-06T14:15:00Z"],
"created_at": ["2025-05-06T14:15:25Z"]
},
"prediction": {
"forecast_days": [5],
"forecast_reliability": ["LOW"]
},
"model": {
"lineups": {
"model_applied": ["385981f2-2712-43f5-9549-7a9e8ce7344a", "a33235eb-7f2f-49a3-a96c-683c99cf019a"],
"model_version": ["1.10", "1.11"],
"training_samples": [82785, 248010],
"date_last_sample": ["2025-04-27", "2025-04-27"]
},
"minutes": {
"model_applied": ["abb0a259-4835-4807-a204-85b825726e41"],
"model_version": ["1.10"],
"training_samples": [86427],
"date_last_sample": ["2025-04-27"]
},
"goals": {
"model_applied": ["ee71e429-088a-4632-8c02-92ad12c64483"],
"model_version": ["1.10"],
"training_samples": [86427],
"date_last_sample": ["2025-04-27"]
},
"assists": {
"model_applied": ["c77d25ad-573d-46f4-8a4f-26855c2b3eae"],
"model_version": ["1.10"],
"training_samples": [86427],
"date_last_sample": ["2025-04-27"]
},
"cards": {
"model_applied": ["2417bb5b-a9be-446b-8c41-690e92ba5636"],
"model_version": ["1.10"],
"training_samples": [86427],
"date_last_sample": ["2025-04-27"]
},
"corners_taken": {
"model_applied": ["5710404d-7e64-42b8-bca2-b17716c3612a"],
"model_version": ["1.11"],
"training_samples": [86427],
"date_last_sample": ["2025-04-27"]
},
"fouls_won": {
"model_applied": ["655d0819-13ce-4263-ac0f-447af55b8a7d"],
"model_version": ["1.11"],
"training_samples": [86427],
"date_last_sample": ["2025-04-27"]
},
"fouls_conceded": {
"model_applied": ["99ffbdd3-e574-42d1-84c4-8f5f3c820bf8"],
"model_version": ["1.11"],
"training_samples": [86427],
"date_last_sample": ["2025-04-27"]
}
}
}
},
{
"key": "predictions/metadata/f61793bf-59e8-4d1b-81bd-458a1fd138dd/2025-05-07T14-15-00Z.json",
"timestamp": "2025-05-07T14:15:00Z",
"data": {
"fixture": {
"id": ["f61793bf-59e8-4d1b-81bd-458a1fd138dd"],
"commence_time": ["2025-05-11T14:15:00Z"]
},
"snapshot": {
"snapshot_time": ["2025-05-07T14:15:00Z"],
"created_at": ["2025-05-07T14:15:18Z"]
},
"prediction": {
"forecast_days": [4],
"forecast_reliability": ["LOW"]
},
"model": {
"lineups": {
"model_applied": ["385981f2-2712-43f5-9549-7a9e8ce7344a", "a33235eb-7f2f-49a3-a96c-683c99cf019a"],
"model_version": ["1.10", "1.11"],
"training_samples": [82785, 248010],
"date_last_sample": ["2025-04-27", "2025-04-27"]
},
"minutes": {
"model_applied": ["abb0a259-4835-4807-a204-85b825726e41"],
"model_version": ["1.10"],
"training_samples": [86427],
"date_last_sample": ["2025-04-27"]
},
"goals": {
"model_applied": ["ee71e429-088a-4632-8c02-92ad12c64483"],
"model_version": ["1.10"],
"training_samples": [86427],
"date_last_sample": ["2025-04-27"]
},
"assists": {
"model_applied": ["c77d25ad-573d-46f4-8a4f-26855c2b3eae"],
"model_version": ["1.10"],
"training_samples": [86427],
"date_last_sample": ["2025-04-27"]
},
"cards": {
"model_applied": ["2417bb5b-a9be-446b-8c41-690e92ba5636"],
"model_version": ["1.10"],
"training_samples": [86427],
"date_last_sample": ["2025-04-27"]
},
"corners_taken": {
"model_applied": ["5710404d-7e64-42b8-bca2-b17716c3612a"],
"model_version": ["1.11"],
"training_samples": [86427],
"date_last_sample": ["2025-04-27"]
},
"fouls_won": {
"model_applied": ["655d0819-13ce-4263-ac0f-447af55b8a7d"],
"model_version": ["1.11"],
"training_samples": [86427],
"date_last_sample": ["2025-04-27"]
},
"fouls_conceded": {
"model_applied": ["99ffbdd3-e574-42d1-84c4-8f5f3c820bf8"],
"model_version": ["1.11"],
"training_samples": [86427],
"date_last_sample": ["2025-04-27"]
}
}
}
},
{
"key": "predictions/metadata/f61793bf-59e8-4d1b-81bd-458a1fd138dd/2025-05-08T14-15-00Z.json",
"timestamp": "2025-05-08T14:15:00Z",
"data": {
"fixture": {
"id": ["f61793bf-59e8-4d1b-81bd-458a1fd138dd"],
"commence_time": ["2025-05-11T14:15:00Z"]
},
"snapshot": {
"snapshot_time": ["2025-05-08T14:15:00Z"],
"created_at": ["2025-05-08T14:15:20Z"]
},
"prediction": {
"forecast_days": [3],
"forecast_reliability": ["MEDIUM"]
},
"model": {
"lineups": {
"model_applied": ["385981f2-2712-43f5-9549-7a9e8ce7344a", "a33235eb-7f2f-49a3-a96c-683c99cf019a"],
"model_version": ["1.10", "1.11"],
"training_samples": [82785, 248010],
"date_last_sample": ["2025-04-27", "2025-04-27"]
},
"minutes": {
"model_applied": ["abb0a259-4835-4807-a204-85b825726e41"],
"model_version": ["1.10"],
"training_samples": [86427],
"date_last_sample": ["2025-04-27"]
},
"goals": {
"model_applied": ["ee71e429-088a-4632-8c02-92ad12c64483"],
"model_version": ["1.10"],
"training_samples": [86427],
"date_last_sample": ["2025-04-27"]
},
"assists": {
"model_applied": ["c77d25ad-573d-46f4-8a4f-26855c2b3eae"],
"model_version": ["1.10"],
"training_samples": [86427],
"date_last_sample": ["2025-04-27"]
},
"cards": {
"model_applied": ["2417bb5b-a9be-446b-8c41-690e92ba5636"],
"model_version": ["1.10"],
"training_samples": [86427],
"date_last_sample": ["2025-04-27"]
},
"corners_taken": {
"model_applied": ["5710404d-7e64-42b8-bca2-b17716c3612a"],
"model_version": ["1.11"],
"training_samples": [86427],
"date_last_sample": ["2025-04-27"]
},
"fouls_won": {
"model_applied": ["655d0819-13ce-4263-ac0f-447af55b8a7d"],
"model_version": ["1.11"],
"training_samples": [86427],
"date_last_sample": ["2025-04-27"]
},
"fouls_conceded": {
"model_applied": ["99ffbdd3-e574-42d1-84c4-8f5f3c820bf8"],
"model_version": ["1.11"],
"training_samples": [86427],
"date_last_sample": ["2025-04-27"]
}
}
}
},
{
"key": "predictions/metadata/f61793bf-59e8-4d1b-81bd-458a1fd138dd/2025-05-09T14-15-00Z.json",
"timestamp": "2025-05-09T14:15:00Z",
"data": {
"fixture": {
"id": ["f61793bf-59e8-4d1b-81bd-458a1fd138dd"],
"commence_time": ["2025-05-11T14:15:00Z"]
},
"snapshot": {
"snapshot_time": ["2025-05-09T14:15:00Z"],
"created_at": ["2025-05-09T14:15:20Z"]
},
"prediction": {
"forecast_days": [2],
"forecast_reliability": ["MEDIUM"]
},
"model": {
"lineups": {
"model_applied": ["385981f2-2712-43f5-9549-7a9e8ce7344a", "a33235eb-7f2f-49a3-a96c-683c99cf019a"],
"model_version": ["1.10", "1.11"],
"training_samples": [82785, 248010],
"date_last_sample": ["2025-04-27", "2025-04-27"]
},
"minutes": {
"model_applied": ["abb0a259-4835-4807-a204-85b825726e41"],
"model_version": ["1.10"],
"training_samples": [86427],
"date_last_sample": ["2025-04-27"]
},
"goals": {
"model_applied": ["ee71e429-088a-4632-8c02-92ad12c64483"],
"model_version": ["1.10"],
"training_samples": [86427],
"date_last_sample": ["2025-04-27"]
},
"assists": {
"model_applied": ["c77d25ad-573d-46f4-8a4f-26855c2b3eae"],
"model_version": ["1.10"],
"training_samples": [86427],
"date_last_sample": ["2025-04-27"]
},
"cards": {
"model_applied": ["2417bb5b-a9be-446b-8c41-690e92ba5636"],
"model_version": ["1.10"],
"training_samples": [86427],
"date_last_sample": ["2025-04-27"]
},
"corners_taken": {
"model_applied": ["5710404d-7e64-42b8-bca2-b17716c3612a"],
"model_version": ["1.11"],
"training_samples": [86427],
"date_last_sample": ["2025-04-27"]
},
"fouls_won": {
"model_applied": ["655d0819-13ce-4263-ac0f-447af55b8a7d"],
"model_version": ["1.11"],
"training_samples": [86427],
"date_last_sample": ["2025-04-27"]
},
"fouls_conceded": {
"model_applied": ["99ffbdd3-e574-42d1-84c4-8f5f3c820bf8"],
"model_version": ["1.11"],
"training_samples": [86427],
"date_last_sample": ["2025-04-27"]
}
}
}
},
{
"key": "predictions/metadata/f61793bf-59e8-4d1b-81bd-458a1fd138dd/2025-05-10T14-15-00Z.json",
"timestamp": "2025-05-10T14:15:00Z",
"data": {
"fixture": {
"id": ["f61793bf-59e8-4d1b-81bd-458a1fd138dd"],
"commence_time": ["2025-05-11T14:15:00Z"]
},
"snapshot": {
"snapshot_time": ["2025-05-10T14:15:00Z"],
"created_at": ["2025-05-10T14:15:19Z"]
},
"prediction": {
"forecast_days": [1],
"forecast_reliability": ["HIGH"]
},
"model": {
"lineups": {
"model_applied": ["385981f2-2712-43f5-9549-7a9e8ce7344a", "a33235eb-7f2f-49a3-a96c-683c99cf019a"],
"model_version": ["1.10", "1.11"],
"training_samples": [82785, 248010],
"date_last_sample": ["2025-04-27", "2025-04-27"]
},
"minutes": {
"model_applied": ["abb0a259-4835-4807-a204-85b825726e41"],
"model_version": ["1.10"],
"training_samples": [86427],
"date_last_sample": ["2025-04-27"]
},
"goals": {
"model_applied": ["ee71e429-088a-4632-8c02-92ad12c64483"],
"model_version": ["1.10"],
"training_samples": [86427],
"date_last_sample": ["2025-04-27"]
},
"assists": {
"model_applied": ["c77d25ad-573d-46f4-8a4f-26855c2b3eae"],
"model_version": ["1.10"],
"training_samples": [86427],
"date_last_sample": ["2025-04-27"]
},
"cards": {
"model_applied": ["2417bb5b-a9be-446b-8c41-690e92ba5636"],
"model_version": ["1.10"],
"training_samples": [86427],
"date_last_sample": ["2025-04-27"]
},
"corners_taken": {
"model_applied": ["5710404d-7e64-42b8-bca2-b17716c3612a"],
"model_version": ["1.11"],
"training_samples": [86427],
"date_last_sample": ["2025-04-27"]
},
"fouls_won": {
"model_applied": ["655d0819-13ce-4263-ac0f-447af55b8a7d"],
"model_version": ["1.11"],
"training_samples": [86427],
"date_last_sample": ["2025-04-27"]
},
"fouls_conceded": {
"model_applied": ["99ffbdd3-e574-42d1-84c4-8f5f3c820bf8"],
"model_version": ["1.11"],
"training_samples": [86427],
"date_last_sample": ["2025-04-27"]
}
}
}
}
]
}Extra headers
You’ll receive these headers in the response:
- x-credits-cost: The usage credit cost of this API call
- x-credits-used: Credits used since the last reset
- x-credits-remaining: Credits remaining until the next reset
Cost
Calling this URL costs 10 usage credits.
GET history fixtures
Returns the list of fixtures available in the 17-day forecast window for a historical snapshot (from 2023-07-25 onwards).
Each fixture includes its unique fixtureId, which you’ll use in other endpoints such as /predictions and /history/* routes.
URL
GET https://api.lineupapi.com/v2/history/fixtures/?date={date}&apiKey={apiKey}
Inputs
date: The timestamp of the snapshot to return (ISO 8601), e.g.
2023-10-20T12:45:00Z.
The API returns the closest snapshot at or before the provided timestamp.apiKey: Your subscription API key. Find it in your dashboard or choose a plan.
Example
URL https://api.lineupapi.com/v2/history/fixtures/?date=2025-04-24T16:00:00Z&apiKey=YOUR_API_KEY
Try it in the browser
https://api.lineupapi.com/v2/history/fixtures/?date=2025-04-24T16:00:00Z&apiKey=YOUR_API_KEY
No data.
Extra headers
You’ll receive these headers in the response:
- x-timestamp-requested: The
datevalue you requested (ISO 8601). - x-timestamp-current: The snapshot timestamp actually returned (ISO 8601).
- x-timestamp-previous: The closest snapshot timestamp before
x-timestamp-current(if available). - x-timestamp-next: The closest snapshot timestamp after
x-timestamp-current(if available). - x-credits-cost: The usage credit cost of this API call
- x-credits-used: Credits used since the last reset
- x-credits-remaining: Credits remaining until the next reset
Cost
Calling this URL costs 10 usage credit.
GET history predictions
Returns the prediction of a fixture for a historical snapshot (from 2023-07-25 onwards).
Use the groups query parameter to select one or more prediction groups (comma-separated).
The request cost scales with the number of unique groups requested. Available groups:
- lineups — starter / benchAndPlay / notPlay probabilities (%)
- minutes — minutes-played bucket probabilities (%)
- cards — yellow / red / no card probabilities (%)
- goals — goal threshold probabilities (%)
- assists — assist threshold probabilities (%)
- corners_taken — corners taken threshold probabilities (%)
- fouls_won — fouls won threshold probabilities (%)
- fouls_conceded — fouls conceded threshold probabilities (%)
URL
GET https://api.lineupapi.com/v2/history/predictions/{fixtureId}/?apiKey={apiKey}&groups={groups}
Inputs
fixtureId: The unique ID of the fixture you want predictions for, in UUID format (e.g.
f61793bf-59e8-4d1b-81bd-458a1fd138dd).
Get valid fixture IDs from/fixtures(field:fixtureId). Use this same ID across prediction and history endpoints.groups: Select which prediction groups to include in the response.
Possible values arelineups,minutes,goals,assists,cards,corners_taken,fouls_won,fouls_conceded.
Provide as a comma-separated list (e.g.groups=lineups,goals,cards).
If you includeallas any group value, the API returns all available groups.date: The timestamp of the snapshot to return (ISO 8601), e.g.
2023-10-20T12:45:00Z.
The API returns the closest snapshot at or before the provided timestamp.apiKey: Your subscription API key. Find it in your dashboard or choose a plan.
Example
URL https://api.lineupapi.com/v2/history/predictions/f61793bf-59e8-4d1b-81bd-458a1fd138dd/?groups=all&date=2025-04-24T16:00:00Z&apiKey=YOUR_API_KEY
Try it in the browser
No data.
Extra headers
You’ll receive these headers in the response:
- x-timestamp-requested: The
datevalue you requested (ISO 8601). - x-timestamp-current: The snapshot timestamp actually returned (ISO 8601).
- x-timestamp-previous: The closest snapshot timestamp before
x-timestamp-current(if available). - x-timestamp-next: The closest snapshot timestamp after
x-timestamp-current(if available). - x-credits-cost: The usage credit cost of this API call
- x-credits-used: Credits used since the last reset
- x-credits-remaining: Credits remaining until the next reset
Cost
The usage quota cost depends on the number of prediction groups in the request.cost = 10 x [number of unique groups]