API v2 Documentation

Endpoints Code Lookup

← All endpoints

datastatus

reference All data services

A query to this endpoint will return metadata about the status of the subsite's database, and a list of known data issues. Queries to this endpoint return all known data issues and are not paginated.

Please note that this endpoint can be used synonymously as status.

NBA Data Status
https://api.natstat.com/v2/datastatus/NBA/?key=XXXX-XXXXXX&format=xml Download sample

Parameters

Path

NameRequiredTypeDescription
level required string The competition level to retrieve information for. A full glossary can be found in the Path Parameters section

Query

NameRequiredTypeDescription
key required string A valid API key in XXXX-XXXXXX format
format optional string The preferred data format: xml, json or php (presented as a SimpleXML object). The default is json
team optional string A valid team ID code to locate known data issues. A list of teams can be retrieved from the teams endpoint
date optional string The game date to limit matched known data issues to. The API will attempt to translate the date, but YYYYMMDD or YYYY-MM-DD are preferred
start optional string The starting game date from which to include matched known data issues (inclusive). The API will attempt to translate the date, but YYYYMMDD or YYYY-MM-DD are preferred
end optional string The ending game date to which to include matched known data issues (inclusive). The API will attempt to translate the date, but YYYYMMDD or YYYY-MM-DD are preferred

Response

NameRequiredTypeDescription
status object Object containing CurrentSeason, SeasonDay, GamesRecent, QualifierCriteria
totals object Object containing DataBackTo,Games,Performances,PlayByPlay,NewsItems,Transactions,Tweets,Videos,KnownDataIssues
Game_ID number The game ID of a known data issue
GameDay number The day of the game with a known data issue
Season number The season of the game with a known data issue
Visitor_ID number The teams ID of the relevant visiting team to a known data issue
Home_ID number The teams ID of the relevant home team to a known data issue
IssueCode string The internal code of the known data issue
Issue string A text description of the known data issue
team object Includes teams metadata about the teams relevant to the data issue
Name string The full name of the team that made the transaction
Abbrev string The two to seven-letter team abbreviation, available via the teams endpoint