AdminConsole
API reference/Workmate Workforce
GETstatefullegacy-source evidence

To get form based check in/out details

/reports/forms/{formId}

Get the complete detail about the check in/check-out activity against the particular form. Get the form Id from the custom form API.

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/forms/AD329238910921?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
formIdrequired
pathstring

Unique ID of the Form. It can be fetched from company setting forms API.

AD329238910921
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
userId
querynumber

Unique ID of the user.

32323
clientId
querynumber

Unique ID of the client.

YOUR_CLIENT_ID
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
6 editable · 0 protected
Generated in eight languages
Environment-backed credentials
GEThttps://workmate.mapmyindia.com/apis/reports/forms/AD329238910921?startTime=1700000000000&endTime=1700000000000&userId=32323&clientId=YOUR_CLIENT_ID
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/forms/AD329238910921?startTime=1700000000000&endTime=1700000000000&userId=32323&clientId=YOUR_CLIENT_ID' \
  --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/forms/{formId}
curl --request GET \
  --url 'https://workmate.mapmyindia.com/apis/reports/forms/AD329238910921?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

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
formsData
array<object>

No field description in the source contract.

example
formsData[].employeeName
string

Name of the Employee

kalaivanan Sundaram
formsData[].employeeId
string

Id of the employee

ce12345
formsData[].branchName
string

Name of the branch

okhla
formsData[].branchCode
string

Code number of the branch

3232
formsData[].userId
number

Unique id of the workmate user.

3232
formsData[].clientName
string

Name of Checked in Client.

Mapmyindia
formsData[].departmentName
string

Name of the Checked in department

product
formsData[].contactPersonName
string

Either client or department contact person name

sundaram
formsData[].checkinDateTime
string

Date & Time at which user checked in against the client

1700000000000
formsData[].checkinAddress
string

checked in location address

1134, indira nagar, second stage, Bangalore -560008
formsData[].checkoutDateTime
string

Date & Time at which user checked out against the client

1700000000000
formsData[].checkoutAddress
string

checked out location address

1135, indira nagar, second stage, Bangalore -560008
formsData[].totalHoursSpent
string

Total time spent at the client location. The time differnece between check-in to check out.

00:03:00
formsData[].remarks
string

Comments entered by the user during the check-out process.

collected the parcel.
formsData[].tags
string

List of selected tags during check in. It indicates the check in purpose.

Meeting
formsData[].customFormData
array<object>

No field description in the source contract.

example
formsData[].customFormData[].label
string

Name of the question or title.

Enter the cash collection details.
formsData[].customFormData[].value
string

Response to the question (lable)

Rs. 250 is being collected.
formsData[].clientEmailId
string

Contact person email id of the checked in client or the department

sundaram@gmail.com
formsData[].clientMobileNo
string

Contact person mobile number of the checked in client or department

934838232
Response example
{
  "formsData": [
    {
      "employeeName": "kalaivanan Sundaram",
      "employeeId": "ce12345",
      "branchName": "okhla",
      "branchCode": 3232,
      "userId": 3232,
      "clientName": "Mapmyindia",
      "departmentName": "product",
      "contactPersonName": "sundaram"
    }
  ]
}
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.