Skip to content

Timeline of specific type for device​

GET
/devices/{id}/timeline/{type}

Gets timeline data of a specific type for a device

You may also be interested in the "Chasm" endpoints for live modern messaging observability.

Various types will take differing times to respond, some will fail depending on the device data and patterns of data available.
Some types require elevated permissions to access, in which case you would receive an error.

Authorizations​

ApiKeyAuth

API Key for authentication. Retrieval from either API version login routes, or other authentication token type. See Authentication for more details.

TypeAPI Key (header: Authorization)
Example"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."

Parameters​

Path Parameters

id*

Identifier of the device. Can be ID, IMEI, or Serial number. Use format 'id:1234', 'imei:139872149701', or 'serial:43000001'

Typestring
Required
type*

Timeline type (bootloader, activation, plans, devicemessage, datapoint, backendnote, pairing, sim)

Typestring
Required

Query Parameters

since

Only return events after this time (RFC3339). Defaults to 14 days ago.

Typestring
until

Only return events before this time (RFC3339). Defaults to now.

Typestring

Request Body​

application/json
JSON
{
}

Responses​

OK

application/json
JSON
{
"data": [
{
"description": "string",
"meta": {
"additionalProperties": "string"
},
"timestamp": "string",
"type": "string"
}
],
"since": "string",
"until": "string"
}

Playground​

Authorization
Variables
Key
Value
Body

Samples​

cURL
JavaScript
PHP
Python