Match detail
get_matchRetrieve a match by ID with live score and minute, plus readable goals and cards; search nearby dates when the ID is absent and flag degraded state.
Instructions
One match by its id, with live score/minute overlaid when it's in play, and, for a match in play or finished, the provider's goals and cards it could read (minute, kind, side, the player when named; match.events in data), never a claim that the list is every goal. Off the World Cup the id is looked for from yesterday to 14 days ahead: window names the provider days searched when it was not there (not found in that span, not "no such match"), and degraded with a match means its state could not be refreshed. Optional prediction-market enrichment carries marketComplete; false means the read was incomplete, not that no signal exists. Get the id from get_today or get_live; to find a team's match without an id, use get_next_fixture. tz/lang/flavor affect formatting.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Match id | |
| tz | No | IANA timezone for kickoff times, e.g. America/Mexico_City | |
| lang | No | Locale for dates, list titles, match status and stage words, a match timeline's kind words (Goal, Yellow card…), the empty and outage sentences, provider attribution, and commentary: en, es, pt or fr (no other value is supported). Without it, or when it is empty, the server's CLAUDINHO_LANG when that is exactly one of the four, else en. The market copy, a few notes and the disclaimer stay English | |
| flavor | No | Commentary flair: off, subtle, full (default: full) | |
| competition | No | The competition: an alias such as premier-league, or an ESPN slug such as eng.1 (list_competitions lists the aliases). Without it: the server's CLAUDINHO_COMPETITION, else the user's saved choice (claudinho follow); with none, the answer is noCompetition |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| match | Yes | ||
| served | No | The shown fixtures whose record the provider's window held; a shown fixture not among them is the bundled schedule's row, its live state unconfirmed | |
| source | No | ||
| window | No | Off the World Cup: a whole read of these provider days (YYYY-MM-DD, inclusive) did not hold the match | |
| partial | No | Present when the provider sent records that could not be used: what is returned is what was read, and may not be the whole answer (absence is not elimination). omitted is how many provider records were left out, when known; they may have lain outside what was asked for, so the count is a bound, not a loss | |
| degraded | No | ||
| competition | No | The competition this answer is for: its ESPN slug, its alias, its name, where the choice came from (flag: the competition argument; env: the server's CLAUDINHO_COMPETITION; saved: the user's saved choice, claudinho follow), and experimental for a slug the supported table does not hold; null with noCompetition when nothing is chosen | |
| unknownTeam | No | Present (true) when the roster the competition has holds no team by that name: the bundled nations on the World Cup; the table read whole and the next 14 days' fixtures elsewhere (a claim about that evidence, not the whole competition: a club out in a qualifying round is in no table). Never stated when the table or the span could not be read whole | |
| unsupported | No | Present (true) when this is not available for this competition yet; an empty result then means "unsupported", not "none found" | |
| inapplicable | No | Present (true) when this competition has no such thing at all (a league season with no knockout tie has no knockout tree) | |
| marketSignal | No | ||
| noCompetition | No | Present (true) when no competition is chosen (no competition argument, no server CLAUDINHO_COMPETITION, no saved choice): nothing was read, competition is null, and the text says what to do (pass competition, or the user runs claudinho follow <alias>) | |
| marketComplete | No | False when optional market enrichment did not check this fixture | |
| rosterEvidence | No | With unknownTeam: the evidence it rests on, the competition's table and span (table) or the World Cup's bundled nations (bundle) | |
| betweenEditions | No | Present when the competition is between editions: the edition named by label ended on ended (the provider's calendar day, YYYY-MM-DD, the season end it states), and nothing in the read is scheduled or in play | |
| rosterIncomplete | No | Present (true) when the competition's roster could not be read whole and the name could not be resolved without it (no match, or only by a code or a partial name); not an outage: ask with the club's full name | |
| responseTruncated | No | ||
| responseTruncation | No |