Poll the state of a worker locate request
Returns the current state of a locate request. The response shape matches both the POST response and the `locate` webhook payload. Once `status` is `completed`, inspect each `devices[]` entry for its outcome: a fresh `location`, `outage_reasons` when the SDK reported outages, or a `device_status` of `disconnected` when the SDK did not wake within the budget.
Returns the current state of a locate request. The response shape matches both the POST response and the locate webhook payload. Once status is completed, inspect each devices[] entry for its outcome: a fresh location, outage_reasons when the SDK reported outages, or a device_status of disconnected when the SDK did not wake within the budget.
In: header
Query Parameters
Unique identifier returned by POST /workers/{worker_handle}/locate.
Response Body
application/json
application/json
application/json
curl -X GET "https://example.com/workers/locate?request_id=string"{ "request_id": "00000000-aaaa-bbbb-cccc-111122223333", "worker_handle": "worker001", "status": "completed", "created_at": "2026-06-03T05:46:57.096Z", "updated_at": "2026-06-03T05:47:10.780Z", "completed_at": "2026-06-03T05:47:10.780Z", "devices": [ { "device_id": "AAA11111-BBBB-2222-CCCC-3333DDDD4444", "status": "completed", "completed_at": "2026-06-03T05:47:10.744Z", "location": { "geometry": { "type": "Point", "coordinates": [ -119.60121, 34.4225 ] } } } ]}{ "detail": {}, "message": "string"}{ "detail": { "<location>": { "<field_name>": [ "string" ] } }, "message": "string"}