Skip to main content
GET
Check measurement freshness

Authorizations

Authorization
string
header
required

API key or access token

Path Parameters

advertiserId
string
required

Unique identifier for the advertiser

Minimum string length: 1
Example:

"12345"

Query Parameters

flightStart
string<date>
required
Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$
flightEnd
string<date>
Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$
geos
string

Response

Check measurement freshness

Measurement data gaps for a flight

status
enum<string>
required

no_sources: the advertiser has no measurement sources. not_evaluated: it has sources, but none was checked, because none has a cadence this check evaluates or none has a window due yet (see sourcesSkipped). evaluated: at least one source was checked against at least one due window.

Available options:
no_sources,
not_evaluated,
evaluated
sourcesEvaluated
integer
required

Number of sources checked against at least one due window. Daily sources are checked for at most the last 366 due days of the flight.

Required range: 0 <= x <= 9007199254740991
sourcesSkipped
object[]
required

Sources not checked, and why: the cadence is not evaluated (only daily and weekly sources are checked), or no window is due yet.

gaps
object[]
required

Each source, window and geo set where expected data has not arrived, most overdue first. Daily sources are checked for at most the last 366 due days of the flight; weekly sources for every week of the flight.

totalMissing
integer
required

Total missing geo-windows across gaps. Zero means nothing is missing only when status is evaluated.

Required range: 0 <= x <= 9007199254740991
mostOverdue
object | null
required
lastUploadDate
string<date-time> | null
required
Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
baselineCoverage
object | null
required

Coverage of the 52 weeks before flightStart for the first source. null when the advertiser has no sources.