AdminConsole
API reference/InTouch Telematics
GETstatefullegacy-source evidence

Gets the live data of devices.

/devices

This API returns accurate live location and related data of vehicles, assets & people with help of connected devices/sensors/mobiles to provide location awareness to users of your app. The API provides real-time visibility of your tracked objects, giving not just location information, but multiple additional fields which add value to your application. The API is capable of being used for multiple use cases: be it for transport - logistics or for personnel information services for all kinds of web or mobile development platforms.

Build a requestGet credentials
Legacy contract evidence

This operation was normalized from a MapmyIndia-generation specification. Validate its current Mappls host, path, package entitlement, authentication generation, and commercial availability before production use.

Request target

Call the operation

GEThttps://intouch.mapmyindia.com/iot/api/devices
Base URLhttps://intouch.mapmyindia.com/iot/api
Authenticationbearer
Journey roleobserve
Content typesNo request body
Path, query, and headers

Parameters

NameLocationTypeDescriptionExample
id
queryinteger

This is the device's ID, a non-mandatory parameter. If not passed then by default the API will return the list of all active devices in the account.

1
includeInActive
queryboolean

Non mandatory boolean field. If this field is not sent then by default API response will send all active devices. If "true" then API reponse will have inactive devices along with active devices. If "false" then API will return only active devices

true
ignoreBeacon
queryboolean

Non mandatory field. If set to true then API will return all devices except those whose device type is beacon(mobile).

true
state
querynumber

Non mandatory field. Input timestamp in this field to fetch only those live locations of devices which have come after the input timestamp. If "state" is sent then by default only active devices will be fetched irrespective of the status of "includeInActive" attribute.

1700000000000
Interactive, local, and credential-safe

Build your request in eight languages

Change source-backed examples once, validate required inputs, and copy the synchronized cURL, JavaScript, Python, Java, C#, Go, PHP, or Ruby request. Credentials remain environment references, and this page never sends a provider request.

Local request composerCode stays local · fixtures are explicit
GETRequest inputs
4 editable · 0 protected
Generated in eight languages
Environment-backed credentials
GEThttps://intouch.mapmyindia.com/iot/api/devices?id=1&includeInActive=true&ignoreBeacon=true&state=1700000000000
Credential-free sandboxExecute this contract without a provider call
How fixtures work
Generated from your inputs
curl --request GET \
  --url 'https://intouch.mapmyindia.com/iot/api/devices?id=1&includeInActive=true&ignoreBeacon=true&state=1700000000000' \
  --header "Accept: application/json" \
  --header "Authorization: Bearer ${MAPPLS_INTOUCH_TOKEN}"

Credential-safe by constructionSet MAPPLS_INTOUCH_TOKEN only in your trusted runtime. Code generation stays local. Sandbox execution sends only bounded fixture inputs to this developer platform and never reads a credential or calls Mappls.

Five language quickstarts

Send a production-shaped request

Examples use environment-backed access tokens, explicit timeouts where supported, status checks, and JSON bodies derived from the source schema. Replace sample identifiers and coordinates with values from your application.

GET /devices
curl --request GET \
  --url 'https://intouch.mapmyindia.com/iot/api/devices' \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN'
Success and failure behavior

Responses

200

OK - successful operation

203

Device Not Found

400

Bad Request - Invalid device ID supplied or invalid data type. For example, input attribute "id" is integer but string value gets passed.

401

Unauthorized Request. Access to API is forbidden.

404

Not Found - URL Not Found

200 response fields

FieldTypeDescriptionExample
data
array<object>

No field description in the source contract.

example
data[].id
integer

No field description in the source contract.

1
data[].active
string

device active statusAllowed: true · false

true
data[].status
number

device movement status 1 -> moving 2 -> idle i,e ignition is on and speed stopped i,e engine is off 4 -> towing i,e ignition is off, but vehicle speed 5 -> no data i,e no communication of device with intouch server or no GPRS signal 6 -> power off 7 -> no gps i,e satellite count is less than 4 8 -> on trip i,e device is currently on an active trip 9 -> free vehicle i,e device is not on any active trip

1
data[].vehicleBattery
number

No field description in the source contract.

13568.98
data[].location
object

No field description in the source contract.

28.612964,77.229463
data[].location.gpsTime
number

No field description in the source contract.

1700000000000
data[].location.gprsTime
number

No field description in the source contract.

1700000000000
data[].location.latitude
number

No field description in the source contract.

28.612964
data[].location.longitude
number

No field description in the source contract.

77.229463
data[].location.address
string

No field description in the source contract.

244, Okhla Industrial Estate Phase 3, New Delhi, Delhi. 2 m from Usha Exim Pvt Ltd pin-110020
data[].location.altitude
number

No field description in the source contract.

234
data[].location.heading
number

No field description in the source contract.

196.868
data[].location.speedKph
number

No field description in the source contract.

27.85
data[].location.odometer
number

No field description in the source contract.

12548.22
data[].deviceDetails
object

No field description in the source contract.

example
data[].deviceDetails.name
string

No field description in the source contract.

DL3CCM8097
data[].deviceDetails.registrationNumber
string

No field description in the source contract.

DL3CCM8097
data[].deviceDetails.deviceType
string

No field description in the source contract.Allowed: car · truck · bus · bike · tracktor · JCB · excavator

car
data[].alerts
object

No field description in the source contract.

example
data[].alerts.deviceId
number

Will come only in case of /alarmLog GET API response

8989
data[].alerts.timestamp
number

Time at which the alert got generated

1700000000000
data[].alerts.latitude
number

No field description in the source contract.

28.612964
data[].alerts.longitude
number

No field description in the source contract.

77.229463
data[].alerts.address
string

Location address at which the alarm got generated

237, Okhla Industrial Estate Phase 3, New Delhi, Delhi. 19 m from Wipro BPO Corporate Office pin-110020
data[].alerts.alarmType
integer

Type of alarm to create. Following are the alarm types & their corresponding IDs. IGNITION: 21, OVERSPEED: 22, UNPLUGGED: 23, PANIC: 24, GEOFENCE: 26, STOPPAGE: 27, IDLE: 28, TOWING: 29, GPRS CONNECTIVITY: 126, VEHICLE BATTERY: 129, MILEAGE: 133, GPS CONNECTIVITY: 146, DISTANCE COVERED: 151, INTERNAL BATTERY VOLTAGE:161

28
data[].alerts.limit
integer

Alarm limit as set in the config. For example, if an overspeed alarm set on limit of 44 km/hr in the alarm config setting, then this attribute will return 44 km/hr

44
data[].alerts.duration
integer

Alarm duration limit as set in the alarm config section. For example, if duration of overspeed alarm is set as 20 secs, then the alarm will generate when the vehicle overspeeds for a duration of 20 secs

20
data[].alerts.actualLimit
integer

The actual data received from the device at that particular moment when the alarm got generated

57
data[].alerts.actualDuration
integer

Actual duration for which the device breached the alarm config limit

25
data[].alerts.severity
integer

0 - Low Severity. 1 - High Severity

1
data[].alerts.data
integer

Describes the state of the alarm. IGNITION(type = 21), 0: OFF & 1: ON. AC(type=25), 0: OFF, 1: ON. GEOFENCE(type=26), 1: Entry & Exit Geofence 2: Entry Geofence, 3: Leaving Geofence & 4: Long Stay In Geofence

1
data[].alerts.geofenceId
number

This is the ID of the geofence for which the alarm got generated. This will come only when the 'type' field return 26 i,e geofence.

987876
data[].canInfo
object

No field description in the source contract.

example
data[].canInfo.calcEngineVal
integer

No field description in the source contract.

0
data[].canInfo.greenDriveType
string

HA(Harsh acceleration), HB(Harsh Breaking), HC(Harsh Cornering)

HA
data[].canInfo.canTimestamp
number

Exact time at which the CAN data got generated by the device

1700000000000
data[].canInfo.coolantTemp
number

No field description in the source contract.

87
data[].canInfo.engineRPM
integer

No field description in the source contract.

796
data[].canInfo.accelPedal
number

This is accelerator pedal value in percentage.

8.4
data[].canInfo.parkBrake
number

This is parking break. 0 means parking break is disengaged & 1 means parking break is engaged

0
data[].canInfo.breakPedal
number

1 means break pedal is engaged & 0 means break pedal is disengaged

0
data[].canInfo.fuelLevel
integer

Level of the fuel in liters

14
data[].canInfo.driverDoor
number

1 means door is open & 0 means door is closed

0
data[].canInfo.headLights
number

1 means ON & 0 means OFF

1
data[].canInfo.blinker
number

1 means ON & 0 means OFF

0
data[].canInfo.gearState
number

0 is Neutral, 1 is Drive, 2 is Sports, 3 is Reverse

1700000000000
data[].canInfo.intakeAirTemp
number

This is the intake air temperature of the engine.

62
data[].canInfo.intakeabsolutePress
number

This is the intake absolute pressure of the engine. It is defined in Pa(Pascal)

42
data[].canInfo.ac
integer

1 means AC is ON & 0 means AC is OFF

0
data[].canInfo.fuelConsAVG
integer

Fuel constant average

99
data[].deviceFaults
array<object>

No field description in the source contract.

example
data[].deviceFaults[].code
integer

No field description in the source contract.

1001
data[].deviceFaults[].timetamp
number

No field description in the source contract.

1700000000000
data[].deviceFaults[].status
integer

Describes the status of the fault which was detected. 0: OPEN & 1: Close.

0
data[].deviceFaults[].closedOn
number

No field description in the source contract.

556567872
data[].currentGeofence
array<number>

No field description in the source contract.

example
data[].todaysDrive
object

No field description in the source contract.

example
data[].todaysDrive.todayKms
number

No field description in the source contract.

55.67
data[].todaysDrive.todayMovementTime
number

Value is in seconds

1700000000000
data[].todaysDrive.todayIdleTime
number

Value is in seconds

1700000000000
data[].todaysDrive.todayDriveCount
integer

No field description in the source contract.

5
Response example
{
  "data": [
    {
      "id": "1",
      "active": true,
      "status": 1,
      "vehicleBattery": 13568.98,
      "location": {
        "gpsTime": 1574736922,
        "gprsTime": 1574736922,
        "latitude": 28.551255163434,
        "longitude": 77.2687,
        "address": "244, Okhla Industrial Estate Phase 3, New Delhi, Delhi. 2 m from Usha Exim Pvt Ltd pin-110020",
        "altitude": 234,
        "heading": 196.868,
        "speedKph": 27.85
      },
      "deviceDetails": {
        "name": "DL3CCM8097",
        "registrationNumber": "DL3CCM8097",
        "deviceType": "car"
      },
      "alerts": {
        "deviceId": 8989,
        "timestamp": 1577589789,
        "latitude": 28.550962381896,
        "longitude": 77.26890675033,
        "address": "237, Okhla Industrial Estate Phase 3, New Delhi, Delhi. 19 m from Wipro BPO Corporate Office pin-110020",
        "alarmType": 28,
        "limit": 44,
        "duration": 20
      },
      "canInfo": {
        "calcEngineVal": 0,
        "greenDriveType": "HA",
        "canTimestamp": 1568362645,
        "coolantTemp": 87,
        "engineRPM": 796,
        "accelPedal": 8.4,
        "parkBrake": 0,
        "breakPedal": 0
      }
    }
  ]
}
stateful integration

Operate it safely

observe

This operation observes durable platform state. Preserve resource identifiers and account for pagination, delay, and eventual consistency.

Keep credentials and raw tokens out of source, client bundles, prompts, and logs.Record the operation ID, status, latency, retry count, and source contract version in traces.Classify 4xx responses before retrying; back off and add jitter for retryable 5xx or transport failures.Persist resource identifiers and apply commands exactly once in effect across retries and event replay.
Auditable source

Contract provenance

Source file
contenthub/dochub/mapmyindia-intouch-rest-apis/custom/device.json
SHA-256
58a17aea1fc8a386e467f0266fb5d92e52e148c709fbcb95565be5c0f25895a4
Normalization
Fields are parsed from OpenAPI. Operational guidance and language samples are generated and labeled separately.