Retrieve device metadata

Retrieve the device metadata. Only partners and administrators can make this call.

Request

Security:

bearerAuth

path Parameters

imei

required

string (IMEI)

The IMEI of the device. The IMEI number can be found on a sticker on the device itself or on the back of the device box.

Example: 357660101000198

Responses

200

Receive the device metadata.

400

Bad request error

401

Unauthorized error

403

Forbidden error

404

Not found error

500

Internal server error

get/devices/{imei}

Request samples

curl
JavaScript
Node.js

curl -i -X GET \
  https://api-prod.surfsight.net/v2/devices/:imei \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Response samples

application/json

{"data": {"name": "Aragorn's car",
"imei": "357660101000198",
"groupId": 32,
"accuracy": 4,
"vehicleType": "Private",
"lat": 32.0598671,
"lon": 34.7827316,
"alt": 234.22,
"speed": 22.51,
"status": "online",
"lastSeenOnline": "2020-01-01T14:48:00.000Z",
"firmwareVersion": "3.9.53",
"deviceModel": "AI-12",
"cameras": [{"cameraId": 1,
"name": "Harry's truck"
}
],
"iccid": "891004234814455936F",
"organizationId": 17,
"dataProfileId": 123
},
"requestId": "df5fg-45fgfdsg-45fg-45454"
}