List American football matches

Returns a paginated list of American football matches with optional filtering

In the plans that cover this sportPay per call without a key: $0.002 in USDC

Parameters

limitinteger · query
Maximum results (1-100)
Default: 50
offsetinteger · query
Results to skip
Default: 0
datestring · query
Filter by date (YYYY-MM-DD)
date_fromstring · query
Matches on or after this date (YYYY-MM-DD)
date_tostring · query
Matches on or before this date (YYYY-MM-DD)
statusstring · query
Filter by status (Not Started, Finished, 1st Quarter, 2nd Quarter, Half Time, 3rd Quarter, 4th Quarter, Overtime)
league_idinteger · query
Filter by league ID
team_idinteger · query
Only matches of this team (home or away, every competition)
orderstring · query
desc for latest first (default: by start time ascending)
One of: asc, desc

JSON with success, the result in data, and where the endpoint pages its results meta.

dataarray of object
away_teamobject
idinteger
namestring
scoreinteger
eventsobject
file_groupstring
home_teamobject
idinteger
namestring
scoreinteger
idinteger
league_gidinteger
league_idinteger
league_namestring
match_idinteger
quarter_scoresobject
otobject
q1object
q2object
q3object
q4object
sportstring
start_datestring
start_timestring
statusstring
timerstring
errorobject
codestring
messagestring
metaobject
attributionstring
Attribution a data source's licence asks for (Cricsheet's history).
limitinteger
offsetinteger
totalinteger
successboolean

Status	Code	When
401	`UNAUTHORIZED`	The key is missing, mistyped or was rotated.
402	`x402 offers`	No key and no valid payment: the body lists what to pay. Only a 200 answer is charged.
403	`FORBIDDEN`	The sport or feature is not in your plan (FEATURE_NOT_IN_PLAN for Insights and other plan features).
429	`RATE_LIMIT_EXCEEDED`	Too many requests (QUOTA_EXCEEDED for the daily limit). Wait for Retry-After.
500	`INTERNAL_ERROR`	Our side. Try again after a few seconds and check the status page.

All errors have the shape described in Errors and limits.

Generated from the OpenAPI file, version 1.0. See it as JSON

Was this page helpful?