---
title: "Get jobs"
method: GET
path: "/loneworker/v1/jobs"
tags: ["Lone Worker"]
---

# Get jobs

`GET /loneworker/v1/jobs`

## Request

- Base URL: `https://api.mitti.com`
- URL: `https://api.mitti.com/loneworker/v1/jobs`
- Auth: HTTP bearer

Retrieves all jobs in your organization.

## Query parameters

- `page_size` integer, required
- `page_token` string
- `filter.search` string
- `filter.statuses` string[]
- `filter.started_at.from` string, date-time
- `filter.started_at.to` string, date-time
- `filter.group_ids` string[]
- `filter.user_ids` string[]
- `filter.job_ids` string[]

## Response `200`

A successful response.

- S12LoneworkerV1GetJobsResponse: The message representing a location and its address.
  - `jobs` S12LoneworkerV1GetJobsResponseJob[]: The list of retrieved jobs.
    - `id` string: The ID of the job.
    - `job_number` string: The number of the job.
    - `status` 'JOB_STATUS_ACTIVE_OK' | 'JOB_STATUS_OVERTIME' | 'JOB_STATUS_IN_PANIC' | 'JOB_STATUS_FINISHED' | 'JOB_STATUS_TRAVELING' | 'JOB_STATUS_CANCELED': The enum representing the various states a job can be in during its lifecycle. - JOB_STATUS_ACTIVE_OK: The job is active and operating normally. - JOB_STATUS_OVERTIME: The job has exceeded the expected duration due to time expiry or missed check-in. - JOB_STATUS_IN_PANIC: The job is in a panic state. - JOB_STATUS_FINISHED: The job has finished. - JOB_STATUS_TRAVELING: The worker is traveling to the job. - JOB_STATUS_CANCELED: The job has been canceled.
    - `job_type_id` string: The ID of the job type.
    - `job_type_name` string: The type of the job.
    - `group_id` string: The ID of the group associated with the job.
    - `user_id` string: The ID of the user performing the job.
    - `started_at` string, date-time: The timestamp when the job started.
    - `start_location` S12LoneworkerV1GetJobsResponseLocation: The message representing a location and time when it was recorded.
      - `latitude` number, double: The geographical latitude.
      - `longitude` number, double: The geographical longitude.
      - `address` string: [Optional] The address of the location.
    - `start_location_notes` string: [Optional] The extra details about the start location (e.g., level, office).
    - `last_known_location` S12LoneworkerV1GetJobsResponseLocation: The message representing a location and time when it was recorded.
      - `latitude` number, double: The geographical latitude.
      - `longitude` number, double: The geographical longitude.
      - `address` string: [Optional] The address of the location.
    - `last_located_at` string, date-time: [Optional] The timestamp when the last known location was recorded.
    - `panic_reason` 'PANIC_REASON_NO_PANIC' | 'PANIC_REASON_FALSE_ALARM' | 'PANIC_REASON_INCIDENT' | 'PANIC_REASON_NEAR_MISS': The enum representing the various reasons a job can resolve a panic state. - PANIC_REASON_NO_PANIC: The job did not have a panic at all. - PANIC_REASON_FALSE_ALARM: The panic state was a false alarm. - PANIC_REASON_INCIDENT: The panic state was due to an incident. - PANIC_REASON_NEAR_MISS: The panic state was due to a near miss.
    - `finished_at` string, date-time: [Optional] The timestamp when the job finished.
  - `next_page_token` string: The token for the next page of results.
  - `total_count` integer: The total number of jobs that match the filter.

## Other responses

- `default`: An unexpected error response.

## Changes

- **2026-11-03** `eb6bb843bf18`: 2 warning, 2 info
  - added the new `JOB_STATUS_CANCELED` enum value to the `jobs/items/status/allOf[#/components/schemas/s12.loneworker.v1.JobStatus]/` response property for the response status `200`
  - added the new `JOB_STATUS_TRAVELING` enum value to the `jobs/items/status/allOf[#/components/schemas/s12.loneworker.v1.JobStatus]/` response property for the response status `200`
  - added the enum value `JOB_STATUS_CANCELED` to the property `items/` of the `query` request parameter `filter.statuses`
  - added the enum value `JOB_STATUS_TRAVELING` to the property `items/` of the `query` request parameter `filter.statuses`

[Operation history](https://skmtc.dev/safetyculture/apis/safetyculture-api/changes/loneworker/v1/jobs/get.md)

---

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