AdminConsole
API reference/InTouch Telematics
GETstatefullegacy-source evidence

Gets drive details of a device.

/devices/drives

This API is used to request the drive details of a vehicle in an account on our telematics platform. A vehicle can be a device/sensor connected to our telematics platform directly or via a third party data aggregator who utilises our telematics platform for tracking services. Drive is a list of reported geo-positions of any object (such as vehicles, assets or people) according to pre-defined conditions

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/drives?deviceId=1&startTime=1700000000000&endTime=1700000000000
Base URLhttps://intouch.mapmyindia.com/iot/api
Authenticationbearer
Journey roleobserve
Content typesNo request body
Path, query, and headers

Parameters

NameLocationTypeDescriptionExample
deviceIdrequired
queryinteger

ID of the device for which the drives need to be fetched

1
startTimerequired
querynumber

The starting timsstamp from which the drives need to be fetched.

1700000000000
endTimerequired
querynumber

The end timestamp till which the drives need to be fetched.

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
3 editable · 0 protected
Generated in eight languages
Environment-backed credentials
GEThttps://intouch.mapmyindia.com/iot/api/devices/drives?deviceId=1&startTime=1700000000000&endTime=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/drives?deviceId=1&startTime=1700000000000&endTime=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/drives
curl --request GET \
  --url 'https://intouch.mapmyindia.com/iot/api/devices/drives?deviceId=1&startTime=1700000000000&endTime=1700000000000' \
  --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[].deviceId
number

Your Device's ID.

67790
data[].location
object

No field description in the source contract.

28.612964,77.229463
data[].location.startAddress
string

No field description in the source contract.

3605, 13th G Main Road, HAL Stage 2, Indiranagar, Bengaluru, Karnataka. 35 m from Supraja Meru pin-560038 (India)
data[].location.startTimestamp
number

this is epoc timestamp

1700000000000
data[].location.endAddress
string

No field description in the source contract.

1139, Sweth Ambara, 1st Cross Road, HAL Stage 2, Indiranagar, Bengaluru, Karnataka. 32 m from AMC Cookware India Pvt Ltd pin-560038
data[].location.endTimestamp
number

this is epoc timestamp

1700000000000
data[].location.avgSpeed
number

speed in km/hr

45.34
data[].movement
object

No field description in the source contract.

example
data[].movement.duration
number

duration in seconds

265
data[].movement.distance
number

Distance im KMs

12.34
data[].movement.idleTime
number

idle time in seconds

1700000000000
data[].movement.movementTime
number

movement time in seconds

1700000000000
data[].movement.stoppageTime
number

stoppage time in seconds

1700000000000
data[].drivingBehaviourCount
object

No field description in the source contract.

example
data[].drivingBehaviourCount.haCount
integer

Harsh Acceleration count

2
data[].drivingBehaviourCount.hbCount
integer

Harsh Breaking Count

5
data[].drivingBehaviourCount.hcCount
integer

Harsh Cornering Count

1
Response example
{
  "data": [
    {
      "deviceId": 67790,
      "location": {
        "startAddress": "3605, 13th G Main Road, HAL Stage 2, Indiranagar, Bengaluru, Karnataka. 35 m from Supraja Meru pin-560038 (India)",
        "startTimestamp": 1574913781,
        "endAddress": "1139, Sweth Ambara, 1st Cross Road, HAL Stage 2, Indiranagar, Bengaluru, Karnataka. 32 m from AMC Cookware India Pvt Ltd pin-560038",
        "endTimestamp": 1574914046,
        "avgSpeed": 45.34
      },
      "movement": {
        "duration": 265,
        "distance": 12.34,
        "idleTime": 265,
        "movementTime": 800,
        "stoppageTime": 1300
      },
      "drivingBehaviourCount": {
        "haCount": 2,
        "hbCount": 5,
        "hcCount": 1
      }
    }
  ]
}
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/drive.json
SHA-256
6cdf4c61bc811cde72adc7d658a90c01a1bb4a1f805c85a4d3cd763c2281f2c3
Normalization
Fields are parsed from OpenAPI. Operational guidance and language samples are generated and labeled separately.