Imported data
bearerAuth Bearer Token (JWT) MasDevices
| Recurso | Descripción |
|---|---|
| DeviceHistory | API for retrieving device history information |
| DeviceSimHistory | API for retrieving device SIM history information |
| DeviceInfo | API for retrieving device hardware metadata by TAC |
bearerAuth Bearer Token (JWT) MasDevices
| Recurso | Descripción |
|---|---|
| DeviceHistory | API for retrieving device history information |
| DeviceSimHistory | API for retrieving device SIM history information |
| DeviceInfo | API for retrieving device hardware metadata by TAC |
Show device history. If a period is not specified, this service will offer device history details for the last 90 days.
PATH PARAMETERS
Executes the request in the context of the given organization
The MSISDN of the device history we want to retrieve.
QUERY PARAMETERS
From datetime used as filter
To datetime used as filter
The date reference field to take into account when looking for the defined (or default) period.
The order in which to return the results, based on the specified time reference.
If true, only the first device change in the specified (or default) period will be returned.
OK Device history retrieved successfully. If the device history is empty for the specified/default period, an empty list will be returned.
{
"msisdn": "612345678",
"deviceHistory": [
{
"imei": "123456789012345",
"imei_sv": "1234567890123456",
"tac": "12345678",
"tenant": "test-org",
"is_device_change": true,
"first_seen": "2024-09-09T00:00:00Z",
"last_seen": "2024-09-09T00:00:00Z"
}
]
}| Property | Type | Description | Constraints | Default | ||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
msisdn
*
| string | The MSISDN of the device. | ||||||||||||||||||||||||||||||||||||||||||
deviceHistory
*
| object[] | List of device history entries. | ||||||||||||||||||||||||||||||||||||||||||
Array items:
| ||||||||||||||||||||||||||||||||||||||||||||
Internal Server Error The request failed to be processed by the server
{
"error": "string",
"message": "string",
"trace_id": "string"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
error | string | |||
message | string | |||
trace_id | string |
curl -X GET 'https://devices.masstack.com/v1/orgs/masmovil/deviceHistory/:msisdn?fromDate=2021-10-10T22%3A00%3A00Z&toDate=2021-10-20T22%3A00%3A00Z&dateReference=last_seen&sort=DESC&onlyFirstDeviceChange=false' \
-H 'Authorization: Bearer {access-token}' \
-H 'Accept: application/json'Show device SIM history. If a period is not specified, this service will offer device sim history details for the last 90 days.
PATH PARAMETERS
Executes the request in the context of the given organization
The MSISDN of the device history we want to retrieve.
QUERY PARAMETERS
From datetime used as filter
To datetime used as filter
OK Device sim history retrieved successfully. If the device SIM history is empty for the specified/default period, an empty list will be returned.
{
"msisdn": "612345678",
"deviceSimHistory": [
{
"imsi": "123456789012345",
"tenant": "test-org",
"first_seen": "2024-09-09T00:00:00Z",
"last_seen": "2024-09-09T00:00:00Z"
}
]
}| Property | Type | Description | Constraints | Default | |||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
msisdn
*
| string | The MSISDN of the device. | |||||||||||||||||||||||||||
deviceSimHistory
*
| object[] | List of device SIM history entries. | |||||||||||||||||||||||||||
Array items:
| |||||||||||||||||||||||||||||
Internal Server Error The request failed to be processed by the server
{
"error": "string",
"message": "string",
"trace_id": "string"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
error | string | |||
message | string | |||
trace_id | string |
curl -X GET 'https://devices.masstack.com/v1/orgs/masmovil/deviceSimHistory/:msisdn?fromDate=2021-10-10T22%3A00%3A00Z&toDate=2021-10-20T22%3A00%3A00Z' \
-H 'Authorization: Bearer {access-token}' \
-H 'Accept: application/json'Show the hardware metadata for a TAC (the first 8 digits of an IMEI).
PATH PARAMETERS
The TAC (Type Allocation Code, the first 8 digits of an IMEI) to look up.
OK Device info retrieved successfully.
{
"tac": "86086503",
"bands": "WCDMA,LTE",
"manufacturer": "Apple",
"is_mobile": true,
"is_tablet": false,
"is_ereader": false,
"is_game_console": false,
"is_tv": false,
"five_g_band": "n1,n3,n28,n78",
"brand_name": "iPhone",
"model_name": "iPhone 15 Pro",
"os_vendor": "Apple",
"os_name": "iOS",
"os_family": "Mobile",
"os_version": "17.4",
"device_type": "Smartphone",
"year_released_mobile_device": 2023,
"esim_count": 1,
"sim_size": "Nano",
"conn_2g": true,
"conn_3g": true,
"conn_4g": true,
"conn_5g": true
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
tac
*
| string | The TAC (first 8 digits of an IMEI) this metadata describes. | ||
bands
*
| string | Comma-separated radio bands the device supports. | ||
manufacturer
*
| string | Device manufacturer. | ||
is_mobile
*
| boolean | Whether the device is a mobile phone. | ||
is_tablet
*
| boolean | Whether the device is a tablet. | ||
is_ereader
*
| boolean | Whether the device is an e-reader. | ||
is_game_console
*
| boolean | Whether the device is a games console. | ||
is_tv
*
| boolean | Whether the device is a TV. | ||
five_g_band
*
| string | Comma-separated 5G NR bands the device supports. | ||
brand_name
*
| string | Commercial brand name. | ||
model_name
*
| string | Commercial model name. | ||
os_vendor
*
| string | Operating system vendor. | ||
os_name
*
| string | Operating system name. | ||
os_family
*
| string | Operating system family. | ||
os_version
*
| string | Operating system version. | ||
device_type
*
| string | GSMA device type classification. | ||
year_released_mobile_device
*
| integer | Year the device was released. | ||
esim_count
*
| integer | Number of eSIMs the device supports. | ||
sim_size
*
| string | Physical SIM form factor. | ||
conn_2g
*
| boolean | Whether the device supports 2G connectivity. | ||
conn_3g
*
| boolean | Whether the device supports 3G connectivity. | ||
conn_4g
*
| boolean | Whether the device supports 4G connectivity. | ||
conn_5g
*
| boolean | Whether the device supports 5G connectivity. |
Not Found No device info is known for the given TAC.
{
"error": "string",
"message": "string",
"trace_id": "string"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
error | string | |||
message | string | |||
trace_id | string |
Internal Server Error The request failed to be processed by the server
{
"error": "string",
"message": "string",
"trace_id": "string"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
error | string | |||
message | string | |||
trace_id | string |
curl -X GET 'https://devices.masstack.com/v1/deviceInfo/86086503' \
-H 'Authorization: Bearer {access-token}' \
-H 'Accept: application/json'