> ## Documentation Index > Fetch the complete documentation index at: https://docs.mileapp.dev/llms.txt > Use this file to discover all available pages before exploring further. # Generate location history token > This endpoint is used to generate tracking token, which are utilized by guest users or public users to view a user's last known location based on the specified date. These token expire 7 days after the creation of the tracking token. ## OpenAPI ````yaml /openapi/public/openapi-task.json post /location-history/generate-token openapi: 3.0.0 info: title: MileApp API - Task version: 3.0.0 description: MileApp API Documentation - RESTful API for field operations management. servers: - url: https://apiweb.mile.app/api/v3 security: - bearerAuth: [] tags: - name: Task description: >- A task is an item of work intended for completion by an assignee. It can embody activities like pickups, deliveries, planning, inspections, sales visits, or other work-related actions within your organization. Tasks encompass essential attributes, including IDs, flow, time, status indicators, assignee information, order index, and other pertinent data. The content of a task is configurable based on your specified flow settings. For instance, tasks can serve as visits during the route optimization process, functioning as pivotal elements. The task can also represent a visit in route optimization, please follow [this link](#tag/Routing) to read more detail. **To see the details of task object, please follow [this link](#tag/task_model)** - name: Location History description: >- Location history is data that stores the user's location points that are sent periodically from the MileApp mobile application if the user activates the tracking feature. However, this endpoint can also be useful for integration into the user's IoT devices such as GPS or other mobile trackers. All location data sent can be visualized in MileApp in real time and makes it easier for users to monitor field activities more accurately. **Related Guide:** [Start Finish Feature](/configuration/start-trip-end-trip-feature) - name: Task Schedule description: >- Task Schedule is a mechanism to generate tasks according to the schedule that is set by you. The task schedule attributes consist of IDs, repetition period data (daily, weekly, etc.), flow structure, task content, and time of the schedule's start & end. This schedule could help you to set a task that will be repeated at a certain period. **To see the details of task schedule object, please follow [this link](#tag/task_schedule_model)** - name: Activity description: >- An Activity is a multi-step task group created from a Workflow template. When you create an Activity, MileApp automatically creates one parent task (with `taskType = activityMaster`) plus one child task (with `taskType = activityChild`) per Workflow step, and copies field values forward between steps according to the Workflow's field mappings. Activities are stored alongside regular tasks — the parent's `_id` is also the Activity ID, and its `subId` array lists every child task in Workflow-step order. After creation, retrieve, update, or delete an Activity through the standard Task endpoints using the Activity master task's ID. **To see the details of Activity object, please follow [this link](#tag/activity_model)** paths: /location-history/generate-token: post: tags: - Location History summary: Generate location history token description: >- This endpoint is used to generate tracking token, which are utilized by guest users or public users to view a user's last known location based on the specified date. These token expire 7 days after the creation of the tracking token. operationId: generateTokenLocationHistory requestBody: content: application/json: schema: $ref: '#/components/schemas/postGenerateTokenLocHistory' required: true responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/TokenResponse' examples: response: value: status: true message: Success. token: >- eyJkYXRhIjoiZXlKcGRpSTZJa1JQYkhKTVFraGtNMFpKV21SRmQxZHFkSEZWTkVFOVBTSXNJblpoYkhWbElqb2lheXRMVVc5aFEzRTJNR28zWjJ0UE1rbFdRa1pUYVU0eU9VbElTa2huVFZOT05WUTVMMko0UkZSVVVWQXlSbXRUVGxOcWJWWmpVVTA1SzBSS1FqTm5SRkppYWl0MWMzSXlWMEZSYVZCbFMydHdlbE15TlhwUVkyeExSa053ZUhoUk5FNTFlWFZIYzNwWVJtWjFNVWRKWm1WSmRWUmliRWs0Tm1KSGFWSXpRVTFpUkZwMWNqRlpNVWNyYVZkNmNXUkhkMU5GTVRaRVIzTlJlakZPTkd0amNFOTRhbEZxTVVKallXWTBQU0lzSW0xaFl5STZJamczTXpBeE9UVTFNalUzTkRGbFlUbGlOMkZsT0dOaU1EWXhZVEkzTWpVek9EQXdObVU0WW1FMU5HTXhOelJrWkdFMk1tSXlZV1JqT1RZeFptUXpPR0lpTENKMFlXY2lPaUlpZlE9PSIsImV4cGlyYXRpb24iOiIyMDI0LTAyLTI3VDA5OjU5OjMzLjA1OTA0OVoifQ== '400': description: Bad Request content: application/json: schema: type: object properties: status: type: boolean description: Shows if the request was successful. message: type: string description: A short message explaining what went wrong. example: status: false message: Bad request - invalid parameters provided. '500': description: Server error content: application/json: schema: type: object properties: status: type: boolean description: Shows if the request was successful. message: type: string description: A short message explaining what went wrong. example: status: false message: Internal server error, please contact support@mile.app. deprecated: false security: - bearerAuth: [] components: schemas: postGenerateTokenLocHistory: title: postGenerateTokenLocHistory example: email: example@mile.app date: '2024-02-20' type: object properties: email: type: string description: |- Required, User's email assigned to the monitored task. **Example:** `example@mile.app` date: type: string description: >- The date indicating the time of user tracking and using the format `Y-m-d`. The default date if not filled in is today's date. **Example:** `2025-02-20` required: - email TokenResponse: type: object properties: status: type: boolean description: Indicates whether the request was successful. message: type: string description: A message providing additional information about the response. token: type: string description: Tracking token data that has been successfully generated. securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT description: Use a valid Bearer token to authenticate. ````