Matches By Date League
This endpoint allows you to retrieve the matches from a specific date and league. The date has a format of YYYY-DD-MM.
Multi-language: This feature allows the user to manually change the language of the API response by adding value to the
lang
attribute. Example:lang=en
.
Pagination: The endpoint uses an offset and limit system. Specify the offset and limit parameters to fetch the desired range of results. The maximum and default number of results per request is 50.
Update Period: The endpoint is updated every day.
Recommended Calls: Limit calls to 1 per day.
Use Cases
Get matches from a specific date and league_idhttps://american-football.sportdevs.com/matches-by-date-league?date=eq.{date}&league_id=eq.{league_id}
Query Parameters
- date text
Default value:
eq.2001-09-09
The date
- league_id integer
Default value:
eq.2856
The id of the league
- offset string
Default value:
0
Limiting and Pagination
- limit string
Default value:
50
Limiting and Pagination
- lang string
Default value:
en
Multi-language
- 200
OK
- application/json
- Schema
- Example (from schema)
Schema array
- date text
The date
- league_id integer
The id of the league
- league_name text
The name of the league
- league_hash_image character varying
Possible values:
<= 64 characters
The hash image of the league
- matches jsonb
The matches
[
{
"date": "2001-09-09",
"league_id": 2856,
"league_name": "NFL",
"league_hash_image": "8177e407783797018a0631b96a5a39a542b59a36b63432905bcc8645b8a97602",
"matches": [
{
"id": 33571,
"name": "New York Jets vs Indianapolis Colts",
"status": "finished",
"duration": 9000,
"season_id": 18517,
"start_time": "2001-09-09T18:00:00+00:00",
"season_name": "NFL 01/02",
"away_team_id": 46511,
"home_team_id": 46540,
"status_reason": "Ended",
"tournament_id": 936,
"away_team_name": "Indianapolis Colts",
"home_team_name": "New York Jets",
"away_team_score": 45,
"home_team_score": 24,
"tournament_name": "NFL, Regular Season",
"away_team_hash_image": "1c90d1520dd9198d2fa6ccaa1047a806fe7f15c28b9f74007d08f62ebb03dc7c",
"home_team_hash_image": "84947a2f1f6fe8550ab5736ebdd8e272afec7766920796977f3cb2f3b7504743",
"tournament_importance": 5,
"away_team_period_1_score": 0,
"away_team_period_2_score": 0,
"away_team_period_3_score": 0,
"away_team_period_4_score": 0,
"home_team_period_1_score": 0,
"home_team_period_2_score": 0,
"home_team_period_3_score": 0,
"home_team_period_4_score": 0
},
{
"id": 33572,
"name": "Kansas City Chiefs vs Las Vegas Raiders",
"status": "finished",
"duration": 9000,
"season_id": 18517,
"start_time": "2001-09-09T18:00:00+00:00",
"season_name": "NFL 01/02",
"away_team_id": 46547,
"home_team_id": 1800,
"status_reason": "Ended",
"tournament_id": 936,
"away_team_name": "Las Vegas Raiders",
"home_team_name": "Kansas City Chiefs",
"away_team_score": 27,
"home_team_score": 24,
"tournament_name": "NFL, Regular Season",
"away_team_hash_image": "28360d99743ecf65e845af5510def80ece617ba326be4b744f9b2eb45efe7b04",
"home_team_hash_image": "25f07bf2edc54e76f6a1ad1cd748a659a27f2496e3f98ea710ec49b204cc0512",
"tournament_importance": 5,
"away_team_period_1_score": 0,
"away_team_period_2_score": 0,
"away_team_period_3_score": 0,
"away_team_period_4_score": 0,
"home_team_period_1_score": 0,
"home_team_period_2_score": 0,
"home_team_period_3_score": 0,
"home_team_period_4_score": 0
},
{
"id": 33573,
"name": "Green Bay Packers vs Detroit Lions",
"status": "finished",
"duration": 9000,
"season_id": 18517,
"start_time": "2001-09-09T18:00:00+00:00",
"season_name": "NFL 01/02",
"away_team_id": 46644,
"home_team_id": 1854,
"status_reason": "Ended",
"tournament_id": 936,
"away_team_name": "Detroit Lions",
"home_team_name": "Green Bay Packers",
"away_team_score": 6,
"home_team_score": 28,
"tournament_name": "NFL, Regular Season",
"away_team_hash_image": "86cd85ce7148a28910373f8663d84bf8665dce5fe6249ee769b9457f52f14b26",
"home_team_hash_image": "bf56755d3dd699ae54693513b06d5b0d0c52526cdf1ae7286803f25042e7683c",
"tournament_importance": 5,
"away_team_period_1_score": 0,
"away_team_period_2_score": 0,
"away_team_period_3_score": 0,
"away_team_period_4_score": 0,
"home_team_period_1_score": 0,
"home_team_period_2_score": 0,
"home_team_period_3_score": 0,
"home_team_period_4_score": 0
},
{
"id": 33574,
"name": "Buffalo Bills vs New Orleans Saints",
"status": "finished",
"duration": 9000,
"season_id": 18517,
"start_time": "2001-09-09T18:00:00+00:00",
"season_name": "NFL 01/02",
"away_team_id": 46624,
"home_team_id": 46439,
"status_reason": "Ended",
"tournament_id": 936,
"away_team_name": "New Orleans Saints",
"home_team_name": "Buffalo Bills",
"away_team_score": 24,
"home_team_score": 6,
"tournament_name": "NFL, Regular Season",
"away_team_hash_image": "748bf0d823d4d1d1adb1e9fdc25b4ac78815890462c05d6a4ea14db9d367be10",
"home_team_hash_image": "ae56975737afb0519c3cbf049c57174a89dd65dcdf8c23aaffbb17084a65f6be",
"tournament_importance": 5,
"away_team_period_1_score": 0,
"away_team_period_2_score": 0,
"away_team_period_3_score": 0,
"away_team_period_4_score": 0,
"home_team_period_1_score": 0,
"home_team_period_2_score": 0,
"home_team_period_3_score": 0,
"home_team_period_4_score": 0
},
{
"id": 33575,
"name": "Tennessee Titans vs Miami Dolphins",
"status": "finished",
"duration": 9000,
"season_id": 18517,
"start_time": "2001-09-09T18:00:00+00:00",
"season_name": "NFL 01/02",
"away_team_id": 46492,
"home_team_id": 46530,
"status_reason": "Ended",
"tournament_id": 936,
"away_team_name": "Miami Dolphins",
"home_team_name": "Tennessee Titans",
"away_team_score": 31,
"home_team_score": 23,
"tournament_name": "NFL, Regular Season",
"away_team_hash_image": "7958e23c90d95335f5eb854ff1b96b8732c691b862e60a2b1c8fdd709ed0fd13",
"home_team_hash_image": "e705b54091d3d726e984d11d577137819101cfbe15b950140f8187bb4dca1190",
"tournament_importance": 5,
"away_team_period_1_score": 0,
"away_team_period_2_score": 0,
"away_team_period_3_score": 0,
"away_team_period_4_score": 0,
"home_team_period_1_score": 0,
"home_team_period_2_score": 0,
"home_team_period_3_score": 0,
"home_team_period_4_score": 0
},
{
"id": 33576,
"name": "Cincinnati Bengals vs New England Patriots",
"status": "finished",
"duration": 9000,
"season_id": 18517,
"start_time": "2001-09-09T18:00:00+00:00",
"season_name": "NFL 01/02",
"away_team_id": 46500,
"home_team_id": 46485,
"status_reason": "Ended",
"tournament_id": 936,
"away_team_name": "New England Patriots",
"home_team_name": "Cincinnati Bengals",
"away_team_score": 17,
"home_team_score": 23,
"tournament_name": "NFL, Regular Season",
"away_team_hash_image": "a1a2fd51ffc0ed20f25905589e21eace918597dc4c8a57b38be5fc77268d0ce5",
"home_team_hash_image": "1f86f1d4e52467ed34f571fac6ba2ba1fd9d6fd8cd0c620a3acb255311cca858",
"tournament_importance": 5,
"away_team_period_1_score": 0,
"away_team_period_2_score": 0,
"away_team_period_3_score": 0,
"away_team_period_4_score": 0,
"home_team_period_1_score": 0,
"home_team_period_2_score": 0,
"home_team_period_3_score": 0,
"home_team_period_4_score": 0
},
{
"id": 33577,
"name": "Baltimore Ravens vs Chicago Bears",
"status": "finished",
"duration": 9000,
"season_id": 18517,
"start_time": "2001-09-09T18:00:00+00:00",
"season_name": "NFL 01/02",
"away_team_id": 46578,
"home_team_id": 46456,
"status_reason": "Ended",
"tournament_id": 936,
"away_team_name": "Chicago Bears",
"home_team_name": "Baltimore Ravens",
"away_team_score": 6,
"home_team_score": 17,
"tournament_name": "NFL, Regular Season",
"away_team_hash_image": "a5630bc934507ae2bff198ab8afc03877da92c52592ec773bce59c47c49867c3",
"home_team_hash_image": "a9daca603827880320f830879d19098a52e7b40a1e124352bab117fd81614aef",
"tournament_importance": 5,
"away_team_period_1_score": 0,
"away_team_period_2_score": 0,
"away_team_period_3_score": 0,
"away_team_period_4_score": 0,
"home_team_period_1_score": 0,
"home_team_period_2_score": 0,
"home_team_period_3_score": 0,
"home_team_period_4_score": 0
},
{
"id": 33578,
"name": "Los Angeles Chargers vs Washington Commanders",
"status": "finished",
"duration": 9000,
"season_id": 18517,
"start_time": "2001-09-09T18:00:00+00:00",
"season_name": "NFL 01/02",
"away_team_id": 46643,
"home_team_id": 46568,
"status_reason": "Ended",
"tournament_id": 936,
"away_team_name": "Washington Commanders",
"home_team_name": "Los Angeles Chargers",
"away_team_score": 3,
"home_team_score": 30,
"tournament_name": "NFL, Regular Season",
"away_team_hash_image": "902fee178adb1eef40c43e4e2bc1a1fc6dd0dfbcfd64866c415448d2fa29abd1",
"home_team_hash_image": "a7983fdc08bb85a4c8a1a2aa2ae49658dd7a1336526b553cf5041fd6eeb25435",
"tournament_importance": 5,
"away_team_period_1_score": 0,
"away_team_period_2_score": 0,
"away_team_period_3_score": 0,
"away_team_period_4_score": 0,
"home_team_period_1_score": 0,
"home_team_period_2_score": 0,
"home_team_period_3_score": 0,
"home_team_period_4_score": 0
},
{
"id": 33579,
"name": "Dallas Cowboys vs Tampa Bay Buccaneers",
"status": "finished",
"duration": 9000,
"season_id": 18517,
"start_time": "2001-09-09T18:00:00+00:00",
"season_name": "NFL 01/02",
"away_team_id": 46592,
"home_team_id": 46647,
"status_reason": "Ended",
"tournament_id": 936,
"away_team_name": "Tampa Bay Buccaneers",
"home_team_name": "Dallas Cowboys",
"away_team_score": 10,
"home_team_score": 6,
"tournament_name": "NFL, Regular Season",
"away_team_hash_image": "d084affeef7615bca92811bb7ecf0fb5a23b4f401b8f599adc414c88c4495b3d",
"home_team_hash_image": "fdd609eddcfaaa7973d4cbaf8d02bf84de8c8c00b0b046a3443798a952a37921",
"tournament_importance": 5,
"away_team_period_1_score": 0,
"away_team_period_2_score": 0,
"away_team_period_3_score": 0,
"away_team_period_4_score": 0,
"home_team_period_1_score": 0,
"home_team_period_2_score": 0,
"home_team_period_3_score": 0,
"home_team_period_4_score": 0
},
{
"id": 33580,
"name": "Seattle Seahawks vs Cleveland Browns",
"status": "finished",
"duration": 9000,
"season_id": 18517,
"start_time": "2001-09-09T18:00:00+00:00",
"season_name": "NFL 01/02",
"away_team_id": 46494,
"home_team_id": 46628,
"status_reason": "Ended",
"tournament_id": 936,
"away_team_name": "Cleveland Browns",
"home_team_name": "Seattle Seahawks",
"away_team_score": 6,
"home_team_score": 9,
"tournament_name": "NFL, Regular Season",
"away_team_hash_image": "c62cd512080012b8a22496c4148664466f589f16bf5c4da5a880cbc705435860",
"home_team_hash_image": "c77136d630d2b19d47ccf92274240af16313341785aa6b47c4baceb836ea3a28",
"tournament_importance": 5,
"away_team_period_1_score": 0,
"away_team_period_2_score": 0,
"away_team_period_3_score": 0,
"away_team_period_4_score": 0,
"home_team_period_1_score": 0,
"home_team_period_2_score": 0,
"home_team_period_3_score": 0,
"home_team_period_4_score": 0
},
{
"id": 33581,
"name": "San Francisco 49ers vs Atlanta Falcons",
"status": "finished",
"duration": 9000,
"season_id": 18517,
"start_time": "2001-09-09T18:00:00+00:00",
"season_name": "NFL 01/02",
"away_team_id": 46593,
"home_team_id": 46582,
"status_reason": "Ended",
"tournament_id": 936,
"away_team_name": "Atlanta Falcons",
"home_team_name": "San Francisco 49ers",
"away_team_score": 13,
"home_team_score": 16,
"tournament_name": "NFL, Regular Season",
"away_team_hash_image": "a525d124a5c5b7d4da812893fa4dccbe3a14d9acdfa7f7f3bfbf83b0006ef44e",
"home_team_hash_image": "7bc52437a3a5c5e302f63d13c3fac528e8469522e91d73e3b77ab01306b23c2d",
"tournament_importance": 5,
"away_team_period_1_score": 0,
"away_team_period_2_score": 0,
"away_team_period_3_score": 0,
"away_team_period_4_score": 0,
"home_team_period_1_score": 0,
"home_team_period_2_score": 0,
"home_team_period_3_score": 0,
"home_team_period_4_score": 0
},
{
"id": 33582,
"name": "Jacksonville Jaguars vs Pittsburgh Steelers",
"status": "finished",
"duration": 9000,
"season_id": 18517,
"start_time": "2001-09-09T18:00:00+00:00",
"season_name": "NFL 01/02",
"away_team_id": 46461,
"home_team_id": 46523,
"status_reason": "Ended",
"tournament_id": 936,
"away_team_name": "Pittsburgh Steelers",
"home_team_name": "Jacksonville Jaguars",
"away_team_score": 3,
"home_team_score": 21,
"tournament_name": "NFL, Regular Season",
"away_team_hash_image": "96fcdf7329f732d526b9c06b17e64ba0018933fe6f4682db1bed439ad3f5fcdb",
"home_team_hash_image": "ed3fa10ecf2141810dfd05a08902b788efc14430d0d40a3147d0f94f8fe1efd7",
"tournament_importance": 5,
"away_team_period_1_score": 0,
"away_team_period_2_score": 0,
"away_team_period_3_score": 0,
"away_team_period_4_score": 0,
"home_team_period_1_score": 0,
"home_team_period_2_score": 0,
"home_team_period_3_score": 0,
"home_team_period_4_score": 0
},
{
"id": 33583,
"name": "Philadelphia Eagles vs Los Angeles Rams",
"status": "finished",
"duration": 9000,
"season_id": 18517,
"start_time": "2001-09-09T18:00:00+00:00",
"season_name": "NFL 01/02",
"away_team_id": 46590,
"home_team_id": 46576,
"status_reason": "Ended",
"tournament_id": 936,
"away_team_name": "Los Angeles Rams",
"home_team_name": "Philadelphia Eagles",
"away_team_score": 20,
"home_team_score": 17,
"tournament_name": "NFL, Regular Season",
"away_team_hash_image": "bde41157104fe109fbb350c5452c012a38757fdd3f99505669d3ffff7d45f86b",
"home_team_hash_image": "e17c62d870bc44cfb847c2ce523d65f727fc3e3311b2188d5ee8ac3b9005f3f6",
"tournament_importance": 5,
"away_team_period_1_score": 0,
"away_team_period_2_score": 0,
"away_team_period_3_score": 0,
"away_team_period_4_score": 0,
"home_team_period_1_score": 0,
"home_team_period_2_score": 0,
"home_team_period_3_score": 0,
"home_team_period_4_score": 0
}
]
}
]