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

# Get jobs

`GET /loneworker/v1/jobs`

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' — 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_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.

---

[API](https://skmtc.net/safetyculture/apis/safetyculture-api.md) · [All operations](https://skmtc.net/safetyculture/apis/safetyculture-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/safetyculture/safetyculture-api/revisions/5be91df61ded/schema)