---
title: "Get GPS trace for a job assignment"
method: GET
path: "/v1/jobs/{jobId}/location-history"
tags: ["Location History"]
---

# Get GPS trace for a job assignment

`GET /v1/jobs/{jobId}/location-history`

## Request

- Base URL: `https://api.workwing.io`
- URL: `https://api.workwing.io/v1/jobs/{jobId}/location-history`
- Auth: HTTP bearer

Returns timestamped lat/lng points recorded during a resource's assignment to a job. This is the engineer's live position, for your own team only. Do not show it to customers: for a customer-facing tracking page use GET /v1/jobs/{jobId}/tracking, which returns a rough location that is safe to share.

## Path parameters

- `jobId` string, uuid, required

## Query parameters

- `resource_id` string, uuid, required

## Response `200`

Points in time order. Empty when the resource is not assigned to the job.

- object: Points in time order. Empty when the resource is not assigned to the job.
  - `data` object[], required
    - `latitude` number, required
    - `longitude` number, required
    - `accuracy` number, nullable, required: Reported accuracy radius in metres
    - `recorded_at` string, date-time, required
  - `meta` object, required
    - `request_id` string, required
    - `timestamp` string, date-time, required
    - `count` integer, required: Number of items in data

---

[API](https://skmtc.dev/workwing/apis/workwing-api.md) · [All operations](https://skmtc.dev/workwing/apis/workwing-api/llms.txt) · [OpenAPI document](https://skmtc.dev/workwing/apis/workwing-api/revisions/54bb14368a35?raw)
