GET Get users movement details · Mappls Developers

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://workmate.mapmyindia.com/apis/reports/movements/32323?startTime=1700000000000&endTime=1700000000000

Base URLhttps://workmate.mapmyindia.com/apis/

Authenticationoauth2 bearer

Journey roleobserve

Content typesNo request body

Path, query, and headers

Parameters

NameLocationTypeDescriptionExample

apiVersionrequired

headerstring

API version should be mentioned in the header along with bearer Token. Available version is v1.0.0, Default version is v1.0.0

v1.0.0

userIdrequired

pathnumber

Unique ID of the user.

32323

startTimerequired

queryinteger

Start time of the report. At a time maximum of 31 days can data can be fetched together. Time in epoch time.

1700000000000

endTimerequired

queryinteger

Start time of the report. At a time maximum of 31 days can data can be fetched together. Time in epoch time.

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

GEThttps://workmate.mapmyindia.com/apis/reports/movements/32323?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://workmate.mapmyindia.com/apis/reports/movements/32323?startTime=1700000000000&endTime=1700000000000' \
  --header "Accept: application/json" \
  --header "Authorization: Bearer ${MAPPLS_ACCESS_TOKEN}"

Credential-safe by constructionSet MAPPLS_ACCESS_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 /reports/movements/{userId}

curl --request GET \
  --url 'https://workmate.mapmyindia.com/apis/reports/movements/32323?startTime=1700000000000&endTime=1700000000000' \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN'

Success and failure behavior

Responses

200

default response

204

Content Not available for the selected period.

400

Bad Request - Invalid ID supplied or invalid data type.

401

Unauthorized Request. Access to API is forbidden.

403

The user type is Field user. Only manager and admin type user have the access to this API

404

Not Found - URL Not Found

406

userId not belong to your account

200 response fields

FieldTypeDescriptionExample

movements

array<object>

No field description in the source contract.

example

movements[].address

string

Users location address for the given time.

40/2, Kalasipalyam, Bengaluru, Karnataka. 18 m from MP Auto Consultancy pin- 560002 (India)

movements[].distance

string

Total traveled distance from start time to this location for the selected period. It is in a kilometer.

10. 00

movements[].driftStatus

integer

Based on the GPS drift this location data is accepted or rejected will be stated. 1 - accepted, 0 - rejected.

1

movements[].heading

integer

GPS angle. It gives the direction of the user.

234

movements[].lat

number

Latitude value of location

28.612964

movements[].long

number

longitude value of the location.

77.843835

movements[].speed

integer

Speed of user at that time. It is a GPS speed.It is in Km/hr

234

movements[].movementStatus

string

Stopped or moving status will be there for the user.

stopped

movements[].gpsTime

integer

GPS time in epochtime stamp. It is the time at which location is being collected from the mobile phone.

1700000000000

movements[].insertTime

integer

Time at which location packet is being received at the server end. It is normally called as GPRS time. it is in EPOCH time format.

1700000000000

movements[].internalBatteryLevel

integer

Phones battery percentage.

24

Response example

{
  "movements": [
    {
      "address": "40/2, Kalasipalyam, Bengaluru, Karnataka. 18 m from MP Auto Consultancy pin- 560002 (India)",
      "distance": "10. 00",
      "driftStatus": 1,
      "heading": 234,
      "lat": 28.550607,
      "long": 77.843835,
      "speed": 234,
      "movementStatus": "stopped"
    }
  ]
}

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