API Overview Resources Schemas

DeviceHistory

API for retrieving device history information

retrieveDeviceHistory

Show device history. If a period is not specified, this service will offer device history details for the last 90 days.

GET /orgs/{orgId}/deviceHistory/{msisdn}

Parameters

Name	In	Type	Required	Description
orgId	path	string	true	Executes the request in the context of the given organization
msisdn	path	string	true	The MSISDN of the device history we want to retrieve.
fromDate	query	string(date-time)	false	From datetime used as filter
toDate	query	string(date-time)	false	To datetime used as filter
dateReference	query	string	false	The date reference field to take into account when looking for the defined (or default) period.
sort	query	string	false	The order in which to return the results, based on the specified time reference.
onlyFirstDeviceChange	query	boolean	false	If true, only the first device change in the specified (or default) period will be returned.

Enumerated Values

Property	Values
dateReference	one of [first_seen, last_seen]
sort	one of [ASC, DESC]

Request example

1
2
3
4
5



curl -X GET https://devices.masstack.com/v1/orgs/masmovil/deviceHistory/{msisdn}?fromDate='2021-10-10T22:00:00Z'&toDate='2021-10-20T22:00:00Z'&dateReference='first_seen'&sort='ASC'&onlyFirstDeviceChange='false' \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}"

Responses

Code	Meaning	Description	Schema
200	OK	Device history retrieved successfully	DeviceHistoryResponseDTO
404	Not Found	Device not found	GenericResponseDTO

Endpoints

DeviceHistory

DeviceSimHistory