Markers

Markers are key/value state that exist on a SIM. Markers are automatically applied to SIMs based on the device the SIM is used in or the state of the SIM itself.

Both the aggregate and time series usage APIs can query usages by markers. The aggregate API accepts marker keys and returns usages grouped by all of the values for the given key. The time series API accepts both a marker key and value and returns the daily usage for the given key/value.

Markers are temporally bound to usage records at a daily granularity. If a marker exists on a SIM over a time range, it will always exist on the SIM for that time range.

Valid marker keys are listed in the table below. Many of these are only available when the SIM is inside a Mason device.

Marker key	Description
imei	The imei associated with the SIM
device-group	The Mason device group the SIM is deployed to
device-uuid	The Mason device uuid the SIM is in
device-type	The Mason device family the SIM is in
incremental	The Android incremental build the device is in
carrier	The carrier the SIM is connected to
mnc	The mobile network code the SIM is connected to
mcc	The mobile carrier code the SIM is connected to
mnc-mcc	The combination of the mobile network and mobile carrier codes the SIM is connected to