GET This API will get all the trips for a user.

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/trips

Base URLhttps://intouch.mapmyindia.com/iot/api

Authenticationbearer

Journey roleobserve

Content typesNo request body

Path, query, and headers

Parameters

NameLocationTypeDescriptionExample

limit

queryinteger

will limit the records as per the passed value.

10

status

queryinteger

pass 1 to get active trips & 2 for completed trips.

1

deviceId

querystring

Pass device IDs if you want to get trips associated with partcular devices.

2223,7654

startTime

querynumber

Pass if you wnat to get trips after this start timestamp.

1700000000000

endTime

querynumber

Pass if you wnat to get trips after this start timestamp.

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

Generated in eight languages

Environment-backed credentials

GET

https://intouch.mapmyindia.com/iot/api/trips?limit=10&status=1&deviceId=2223%2C7654&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/trips?limit=10&status=1&deviceId=2223%2C7654&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 /trips

curl --request GET \
  --url 'https://intouch.mapmyindia.com/iot/api/trips' \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN'

Success and failure behavior

Responses

200

OK - successful operation

203

Device Not Found

400

Bad Request - Invalid ID supplied or invalid data type.

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[].tripId

string

id of the trip

5ef5a9e98a92df3a4a894db0

data[].deviceId

number

id of the device which is associated with the trip.

1

data[].status

integer

1 - active trip. 2 - completed trip

1

data[].closureType

integer

type of trip closure. 1 - trip will get closed based on the planned end time. 2 - trip will close when the device enters the destination area/geofence. 3 - trip will get closed manually by the user

1

data[].forceClose

boolean

boolean value - if true then trip will get automatically closed as soon as the device gets associated with another trip.

true

data[].name

string

name of the trip

my trip

data[].polylinePoints

object

This is the route polyline. It Will get returned for single trip only if polyline query param is set to true in the API.

example

data[].polylinePoints.coordinates

array<object>

No field description in the source contract.

28.612964,77.229463

data[].polylinePoints.coordinates[].lng

number

longitude point

77.229463

data[].polylinePoints.coordinates[].lat

number

latititude point

28.612964

data[].location

object

location data of the device. This will get returned only for a single trip when the 'deviceLocation' query param is set to true in the API.

28.612964,77.229463

data[].location.gpsTime

number

gps time of the device

1700000000000

data[].location.gprsTime

number

gps time of the device

1700000000000

data[].location.latitude

number

latitude

28.612964

data[].location.longitude

number

longitude

77.229463

data[].location.address

string

last location address of the device

example

data[].location.status

number

movement status of the device 1 is Moving 2 is idle 3 is stopped 4 is towing 5 is No Data 6 is power off i,e the device's battery is disconnected from the vehicle battery 7 is No GPS 12 is Activation Pending i,e the device is not yet active and is yet to send the first ping.

3

data[].positionEvents

array<object>

No field description in the source contract.

example

data[].positionEvents[].timestamp

number

No field description in the source contract.

1700000000000

data[].positionEvents[].longitude

number

No field description in the source contract.

77.229463

data[].positionEvents[].latitude

number

No field description in the source contract.

28.612964

data[].destination

object

This object will only get returned if the user has given a specific desntination as input while creating a trip

example

data[].destination.geometry

object

This is standard geo json format.

28.612964,77.229463

data[].destination.geometry.type

string

supports the following geometry types - Point, Polygon.

Point

data[].destination.geometry.coordinates

array<number>

No field description in the source contract.

28.612964,77.229463

data[].destination.radius

number

radius of the point

100

data[].destination.plannedTime

number

planned timestamp at which device reach the destination

1700000000000

data[].destination.name

string

name of the geofence point

example

data[].destination.arrivalTime

number

actual timestamp at which device reach the destination

1700000000000

data[].destination.departureTime

number

departure timestamp at which device leaves the destination

1700000000000

data[].destination.address

string

address of the desntination point

example

data[].destination.time

number

planned timestamp taken to reach the destination from previous point

1700000000000

data[].destination.distance

number

planned distance taken to reach the destination from previous point

1

data[].destination.pointName

string

name given to the destination point.

example

data[].destination.metadata

object

will get returned only if it was mentioned while creating a trip.

example

data[].destination.metadata.myattribute

string

dummy meta data value. this can be any key-value data pair.

sample text

data[].geofences

array<object>

various points of the trip. This will only get returned in case the these geofence points were explicitly mentioned while creating a trip

example

data[].geofences[].geometry

object

This is standard geo json format.

28.612964,77.229463

data[].geofences[].geometry.type

string

supports the following geometry types - Point, Polygon.

Point

data[].geofences[].geometry.coordinates

array<number>

No field description in the source contract.

28.612964,77.229463

data[].geofences[].radius

number

radius of the point

100

data[].geofences[].plannedTime

number

planned timestamp at which device reach the destination

1700000000000

data[].geofences[].name

string

name of the geofence point

example

data[].geofences[].arrivalTime

number

actual timestamp at which device reach the destination

1700000000000

data[].geofences[].departureTime

number

departure timestamp at which device leaves the destination

1700000000000

data[].geofences[].address

string

address of the desntination point

example

data[].geofences[].time

number

planned timestamp taken to reach the destination from previous point

1700000000000

data[].geofences[].distance

number

planned distance taken to reach the destination from previous point

1

data[].geofences[].pointName

string

name given to the destination point.

example

data[].geofences[].metadata

object

will get returned only if it was mentioned while creating a trip.

example

data[].geofences[].metadata.myattribute

string

dummy meta data value. this can be any key-value data pair.

sample text

data[].start

object

start point of the trip. This will only get returned in case the start point was explicitly mentioned while creating a trip

example

data[].start.geometry

object

This is standard geo json format.

28.612964,77.229463

data[].start.geometry.type

string

supports the following geometry types - Point, Polygon.

Point

data[].start.geometry.coordinates

array<number>

No field description in the source contract.

28.612964,77.229463

data[].start.radius

number

radius of the point

100

data[].start.plannedTime

number

planned timestamp at which device reach the destination

1700000000000

data[].start.name

string

name of the geofence point

example

data[].start.arrivalTime

number

actual timestamp at which device reach the destination

1700000000000

data[].start.departureTime

number

departure timestamp at which device leaves the destination

1700000000000

data[].start.address

string

address of the desntination point

example

data[].start.time

number

planned timestamp taken to reach the destination from previous point

1700000000000

data[].start.distance

number

planned distance taken to reach the destination from previous point

1

data[].start.pointName

string

name given to the destination point.

example

data[].start.metadata

object

will get returned only if it was mentioned while creating a trip.

example

data[].start.metadata.myattribute

string

dummy meta data value. this can be any key-value data pair.

sample text

data[].summary

object

No field description in the source contract.

example

data[].summary.startedOn

number

the actual start timestamp of the trip.

1

data[].summary.duration

number

the actual duration time (in seconds) of the trip.

1

data[].summary.distance

number

the actual distance (in meters) covered in the trip.

7876.33

data[].summary.endedOn

number

the actual end timestamp of the trip.

1593157994

data[].summary.delayedBy

number

the actual timestamp by which the trip got delayed.

1

data[].summary.plannedEndTime

number

the planned end timestamp of the trip.

1700000000000

data[].summary.plannedStartTime

number

the planned start timestamp of the trip.

1700000000000

data[].summary.plannedDuration

number

the planned duration time (in seconds) of the trip.

1

data[].summary.plannedDistance

number

the planned distance (in meters) of the trip.

1

Response example

{
  "data": [
    {
      "tripId": "5ef5a9e98a92df3a4a894db0",
      "deviceId": "1",
      "status": 1,
      "closureType": 1,
      "forceClose": "true",
      "name": "my trip",
      "polylinePoints": {
        "coordinates": []
      },
      "location": {
        "gpsTime": 1593261959,
        "gprsTime": 1593261959,
        "latitude": 29.507586,
        "longitude": 79.507586,
        "address": "example",
        "status": 3
      }
    }
  ]
}

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/trip.json
SHA-256: f475d06cfb9d7bafd8521d713749489be1b26d16de205007fd0b42eef06c254f
Normalization: Fields are parsed from OpenAPI. Operational guidance and language samples are generated and labeled separately.
Source record: Open repository audit