Data API · Change feeds

List match changes

GET/api/v1/datas/match-delta

Returns changed match records in the requested time range.

Bearer authentication required · service: data_api

Reference only — this page never sends API requests or exposes token controls.

Response formats

When format is listed below, use json for the response documented here, or csv and xml for downloads. JSON uses camelCase by default; set case=snake_case when supported for legacy key names. Nested response fields use dot notation; [] denotes an array item and {key} a dynamic object key.

Query parameters

Parameter	Type	Required	Description
fromDate	string	Required	Start of the change range. Format: YYYY-MM-DDTHH:MM.
toDate	string	Required	End of the change range. Format: YYYY-MM-DDTHH:MM; must not precede fromDate.
format	string	Required	Response format. Allowed: json, csv, xml.
seasonId	integer	Optional	Season filter. Minimum 1.
competitionId	integer	Optional	Competition filter. Minimum 1.
page	integer	Optional	Page number. Default: 1. Minimum 1.
perPage	integer	Optional	Items per page. Default: 20. Minimum 1; maximum 100.
case	string	Optional	JSON response key style. Default: camelCase. Allowed: camelCase, snake_case.

Response attributes

Attribute	Type	Description
items	array	Changed match records.
items[].id	integer	Match ID.
items[].date	string\|null	Match date (YYYY-MM-DD).
items[].round	string\|integer\|null	Competition round.
items[].kickoffTime	string\|null	Kickoff time.
items[].homeSquadId	integer	Home squad ID.
items[].awaySquadId	integer	Away squad ID.
items[].homeTeamScore	integer\|null	Home-team score. Only published once the analysis has produced it; null while a match is still being worked on, so a fixture is never reported as a false 0-0.
items[].awayTeamScore	integer\|null	Away-team score. Only published once the analysis has produced it; null while a match is still being worked on, so a fixture is never reported as a false 0-0.
items[].seasonId	integer	Season ID.
items[].fieldId	integer\|null	Field ID.
items[].dimensionLength	number\|null	Field length.
items[].dimensionWidth	number\|null	Field width.
items[].status	string	Where the match stands in the calendar: Scheduled until kickoff, Ended once the kickoff time has passed, whatever our analysis has done. The same value on every endpoint that publishes it. Use matchStatus for the delivery state.
items[].statusId	integer	Numeric form of status: 1 Scheduled, 7 Ended.
items[].matchStatus	integer\|null	Delivery state: 1 not started, 8 in progress, 9 delivered, 10 rejected (final), 11 on hold (paused, may resume), 12 no detailed match data. Describes our analysis, not the score - see hasFinalScore.
items[].matchStatusLabel	string\|null	Delivery state as a name: not_started, in_progress, delivered, rejected, on_hold, data_unavailable.
items[].matchStatusUpdatedAt	string\|null	UTC timestamp of the last delivery-state change (ISO 8601).
items[].hasFinalScore	boolean	Whether the published score is the final one.
items[].providerId	string\|integer\|null	Provider identifier.
meta	object	Pagination metadata.
meta.currentPage	integer	Current page number.
meta.perPage	integer	Requested page size.
meta.total	integer	Total number of matching records.
meta.lastPage	integer	Last available page number.
meta.from	integer\|null	Position of the first item on this page.
meta.to	integer\|null	Position of the last item on this page.
links	object	Pagination URLs.
links.first	string	URL of the first page.
links.last	string	URL of the last page.
links.previous	string\|null	URL of the previous page, when available.
links.next	string\|null	URL of the next page, when available.