AdminConsole
API reference/Workmate Workforce
GETstatefullegacy-source evidence

To get the list of tasks and their details

/tasks

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/tasks
Base URLhttps://workmate.mapmyindia.com/apis/
Authenticationoauth2 bearer
Journey roleobserve
Content typesNo request body
Path, query, and headers

Parameters

NameLocationTypeDescriptionExample
apiVersionrequired
headerstring

Header for this API. Available values are v1.0.0, Default value is v1.0.0

v1.0.0
startTime
querynumber

Enter the start time for the select period. It is in Epoch Time.

1700000000000
endTime
querynumber

Enter the end time for the select period. It is in EPOCH Time.

1700000000000
ownerId
querynumber

Unqiue Id of the the user who has created this task.

1
assigneeId
querynumber

Unique Id of the user who performs this task.

1
clientDetails
queryboolean

To get client location details for the task.

true
activityDetails
queryboolean

To get Activity details against the task.

true
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
7 editable · 0 protected
Generated in eight languages
Environment-backed credentials
GEThttps://workmate.mapmyindia.com/apis/tasks?startTime=1700000000000&endTime=1700000000000&ownerId=1&assigneeId=1&clientDetails=true&activityDetails=true
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/tasks?startTime=1700000000000&endTime=1700000000000&ownerId=1&assigneeId=1&clientDetails=true&activityDetails=true' \
  --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 /tasks
curl --request GET \
  --url 'https://workmate.mapmyindia.com/apis/tasks' \
  --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

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 does not belong to your account

200 response fields

FieldTypeDescriptionExample
tasks
array<object>

No field description in the source contract.

example
tasks[].id
string

Unique Id of the task

32
tasks[].name
string

Name of the task

Document Collection from client
tasks[].description
string

Detailed description of task.

Collect documents like PAN Card, Passport and the application form.
tasks[].priority
number

Task priority . 0 - None, 1- Low, 2 - Medium, 3 - High.

1
tasks[].taskListId
string

Unique Id number of the task list

23
tasks[].taskListName
string

Name of the Task list

323
tasks[].ownerId
number

Unique user Id of the Task owner. The user who created this task

23
tasks[].status
string

Indicates the current status of the task like 1- unassigned, 2- assigned, 3- read, 4- work in progress, 5- overdue, 6- completed, 7- completed early, 8- completed later, 9- manually closed.

2
tasks[].creationDate
number

Date in which the task is created. It is in EPOCH time.

1472668079
tasks[].dueDate
number

Due date of the task. Task should be completed on or before this date. It is in EPOCH time.

1472667900
tasks[].assigneeId
number

Unique id of the user who is going to perform this task.

148
tasks[].clientId
number

Unique Id of the client. The task should be perfomed at this locaton. It is a Task location.

YOUR_CLIENT_ID
tasks[].updationDate
number

Last activity time against this task.

1472742952
tasks[].departmentId
number

Unique ID of the Department where task need to be done.

1
tasks[].checkinId
number

Unique Id of the check in activity against this task

323
tasks[].clientName
string

Name of the client. The task should be performed at this client lcoation.

Cafe coffee day Indiranagar
tasks[].departmentName
string

Department Name of the client. The task should be perfomed at this client department lcoation.

Sales department
tasks[].ownerName
string

Name of the task owner.

sandeep kumar
tasks[].asigneeName
string

Name of the assinee. who is going to perform this task.

lok priya.
tasks[].clientDetails
object

No field description in the source contract.

example
tasks[].clientDetails.lat
number

Latitude value of the task location

28.612964
tasks[].clientDetails.long
number

Longitude value of the task location

77.392323
tasks[].clientDetails.address
string

Task location address

237, okhla phase 3, delhi -110020
tasks[].clientDetails.personName
string

Either client or department Contact person name

Dinesh
tasks[].clientDetails.emailId
string

Either client or department contact person email id.

workmate@mapmyindia.com
tasks[].clientDetails.mobileNo
string

Either client or department contact contact mobile number

9348332321
tasks[].activityDetails
object

No field description in the source contract.

example
tasks[].activityDetails.checkInDetails
object

No field description in the source contract.

example
tasks[].activityDetails.checkInDetails.lat
number

Latitude value of the check in location

28.612964
tasks[].activityDetails.checkInDetails.long
number

Longitude value of the check in location

77.32823
tasks[].activityDetails.checkInDetails.address
string

Check in location address

236, oklha phase 3 , new delhi - 110020
tasks[].activityDetails.checkInDetails.time
number

Check in time, in Epoch Timestamp

1700000000000
tasks[].activityDetails.checkOutDetails
object

No field description in the source contract.

example
tasks[].activityDetails.checkOutDetails.lat
number

Latitude value of the check in location

28.612964
tasks[].activityDetails.checkOutDetails.long
number

Longitude value of the check in location

77.32823
tasks[].activityDetails.checkOutDetails.address
string

Check in location address

236, oklha phase 3 , new delhi - 110020
tasks[].activityDetails.checkOutDetails.time
number

Check in time, in Epoch Timestamp

1700000000000
tasks[].activityDetails.checkOutDetails.comments
string

check out comments

Task is completed
Response example
{
  "tasks": [
    {
      "id": 32,
      "name": "Document Collection from client",
      "description": "Collect documents like PAN Card, Passport and the application form.",
      "priority": 1,
      "taskListId": 23,
      "taskListName": 323,
      "ownerId": 23,
      "status": 2
    }
  ]
}
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/Task-Management.json
SHA-256
0e978659200a849331e1bf5dca4d90ff915eb72100ef85155b046cd98b007365
Normalization
Fields are parsed from OpenAPI. Operational guidance and language samples are generated and labeled separately.