AdminConsole
API reference/Workmate Workforce
GETstatefullegacy-source evidence

Get users attendance details with travelled distance.

/reports/attendances

These APIs follow OAuth2 based security. To know more about how to create your authorization tokens, please use our authorization token URL. More details available here. The API leverages OAuth 2.0 based security. Hence, the developer would need to send a request for an access token using their clientid and clientsecret to the OAuth API. Once validated from the OAuth API, the accesstoken and the tokentype need to be sent as Authorization header with the value: "{tokentype} {accesstoken}”. Authorization : tokentype accesstoken.

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://workmate.mapmyindia.com/apis/reports/attendances?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
userId
queryinteger

No parameter description in the source contract.

1
startTimerequired
queryinteger

No parameter description in the source contract.

1700000000000
endTimerequired
queryinteger

No parameter description in the source contract.

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://workmate.mapmyindia.com/apis/reports/attendances?userId=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://workmate.mapmyindia.com/apis/reports/attendances?userId=1&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/attendances
curl --request GET \
  --url 'https://workmate.mapmyindia.com/apis/reports/attendances?startTime=1700000000000&endTime=1700000000000' \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN'
Success and failure behavior

Responses

200

default response

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 user type user has the access to this API.

404

Not Found - URL Not Found

406

userId not belong to your account

200 response fields

FieldTypeDescriptionExample
attendances
array<object>

No field description in the source contract.

example
attendances[].name
string

Name of the user.

Lok Priya
attendances[].employeeId
string

Id of the employee

ce003232
attendances[].branchName
string

Employees Branch Name

Bangalore
attendances[].branchCode
string

Employee's Branch Code

232
attendances[].userId
string

Employee's Branch Code

232
attendances[].workStartTime
integer

Time at which work is being started in Epoch Time.

1700000000000
attendances[].workEndTime
integer

Time at which work is being started in Epoch Time.

1700000000000
attendances[].workEndRemark
string

Remarks entered by the user while concluding the work.

Completed todays work.
attendances[].workStartRemark
string

emarks entered by the user while starting the work.

Starting my work from client location.
attendances[].workEndAddress
string

Location at which work is being concluded

237,okhla phase3, New delhi -110020
attendances[].workStartAddress
string

Location at which work is being concluded

237,okhla phase3, New delhi -110020
attendances[].workEndLatitude
number

Latitude value of Work end location

28.612964
attendances[].workEndLongitude
number

Longitude value of Work end location

77.229463
attendances[].workStartLatitude
number

Longitude value of Work Start location

28.612964
attendances[].workStartLongitude
number

Longitude value of Work Start location

77.229463
attendances[].workEndOdometer
number

work end Odometer reading.

20
attendances[].workStartOdometer
number

Work start Odometer reading.

10
attendances[].costFactor
number

Per km traveled cost. It will be multiplied against distance traveled by the user.

3.5
attendances[].distance
number

Total travel distance between work start to work end activity. It is calculated based on the location details collected from app

26.07931
Response example
{
  "attendances": [
    {
      "name": "Lok Priya",
      "employeeId": "ce003232",
      "branchName": "Bangalore",
      "branchCode": 232,
      "userId": 232,
      "workStartTime": 1573064999,
      "workEndTime": 1573018435,
      "workEndRemark": "Completed todays work."
    }
  ]
}
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.