GET To get all the user details which belongs to your organization.

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

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

workPlace

queryboolean

Send true if you want to get the work place location details

true

userId

querynumber

send the user Ids in comma separated format to get the list of selected user details. If it is not passed all the user details will be fetched.

3223,23

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/users?workPlace=true&userId=3223%2C23

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/users?workPlace=true&userId=3223%2C23' \
  --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 /users

curl --request GET \
  --url 'https://workmate.mapmyindia.com/apis/users' \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN'

Success and failure behavior

Responses

200

API call is succesful

204

content not found. Check your input values.

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

200 response fields

FieldTypeDescriptionExample

users

array<object>

No field description in the source contract.

example

users[].id

integer

Unqiue workmate Id of the user

232

users[].emailId

string

Unique email Id of the user. This will be used to login to workmate account.

vtsupport@mapmyindia.com

users[].originId

integer

Users workmate account id

32

users[].name

string

Name of the user.

kalaivanan

users[].status

string

It gives users active or inactive status . 1 - Active user, 0- Inactive user.

1

users[].type

integer

Three user type is there in workmate. 0 -admin, 1 -manager, 2 - field user

0

users[].creationTime

integer

Time at which user is being created over workmate. It is an Local EPCH time.

1700000000000

users[].workplaceId

integer

Unique Id of the Work place.

MMI000

users[].costFactor

number

per km travelled cost. It will be multiplyed against distance travelled by the user.

3.4

users[].reportingToName

string

Direct manager of the user.

Sanjay

users[].reportingToId

string

Manger's unique user Id

2323

users[].employeeId

string

Employee unquie ID based on the company record

CE003121

users[].branchName

string

Users branch name of the work place.

Bangalore

users[].branchCode

string

Users branch code of the work place.

CE12

users[].workPlace

object

No field description in the source contract.

example

users[].workPlace.lat

number

Workmate place location latitude

28.612964

users[].workPlace.long

number

Workmate place location longitude.

78.3223

users[].workPlace.name

string

Work location name

Bangalore office

users[].workPlace.address

string

work place address

1134, Dr SK Karim Khan Road, HAL Stage 2, Indiranagar, Bengaluru, Karnataka. 0 m from MapmyIndia Bangalore pin-560008 (India)

Response example

{
  "users": [
    {
      "id": 232,
      "emailId": "vtsupport@mapmyindia.com",
      "originId": 32,
      "name": "kalaivanan",
      "status": 1,
      "type": 0,
      "creationTime": 1458987749,
      "workplaceId": 32
    }
  ]
}

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