Periods

The periods array provides technical timing data for each segment of the match, including timestamps, added time, and clock state.

Field Definitions

FieldTypeDescription
period_idintegerUnique identifier for this specific period instance.
fixture_idintegerUnique identifier for the associated match.
startedintegerUnix timestamp indicating when the period began.
endedintegerUnix timestamp indicating when the period finished (null if live).
counts_fromintegerThe minute the clock starts at for this period (e.g., 45 for 2nd half).
tickingintegerBoolean-style flag (0 or 1) indicating if the clock is currently running.
sort_orderintegerThe chronological sequence of the period.
time_addedintegerThe amount of injury/stoppage time added by the referee.
period_lengthintegerThe regulation duration of the period in minutes (usually 45).
minutesintegerTotal minutes elapsed since the start of the match.
secondsintegerAdditional seconds elapsed beyond the full minutes.
developer_nameenumMachine-readable name (matches the keys in the Score schema).

Developer Name Values

The developer_name field uses the following constant values to describe the match state:

type_idValueDescription
11ST_HALFTotal goals scored during the first half.
22ND_HALFThe total score at the end of the second half.
32ND_HALF_ONLYGoals scored exclusively during the second half period.
4ET_1ST_HALFGoals scored during the first period of extra time.
5ET_2ND_HALFGoals scored during the second period of extra time.
6ETTotal score at the conclusion of all extra time periods.
7PENALTY_SHOOTOUTTotal successful penalties recorded in a shootout.
8CURRENTThe total live score for the team at the current moment.

This types are from developer_type: period

Example JSON

{
    "periods": [
        {
            "period_id": 2045635,
            "fixture_id": 1033370,
            "started": 1776875170,
            "ended": 1776878125,
            "counts_from": 0,
            "ticking": 0,
            "sort_order": 1,
            "time_added": 4,
            "period_length": 45,
            "minutes": 49,
            "seconds": 15,
            "developer_name": "1ST_HALF"
        }
    ]
}