---
title: "List all Staff Members"
method: GET
path: "/staff.json"
tags: ["Staff Members"]
---

# List all Staff Members

`GET /staff.json`

#### Filtering
This endpoint supports result filtering. For more information on how to filter this request, [go here](/docs/filtering).
			
			
#### OAuth Scope
This endpoint requires the following OAuth scope **read_staff**.

## Response `200`

An array of Staff Members

- Staff[]
  - `first` string, required — Staff First Name
  - `last` string, required — Staff Last Name
  - `email` string, email, required — Staff Email Address. This is also your login name.
  - `mobile` string — Mobile phone number of the staff member. Used for SMS communications and identification when calling.
  - `lng` number, float — Longitude coordinate of the staff member's current or last known location. Used for tracking staff locations and calculating routes and travel distances.
  - `lat` number, float — Latitude coordinate of the staff member's current or last known location. Used for tracking staff locations and calculating routes and travel distances.
  - `geo_timestamp` string — The date and time when the staff member's geographic location (lat/lng) was last updated. Format is YYYY-MM-DD HH:MM:SS. Used to determine how recent the location data is.
  - `job_title` string — The staff member's job title or role within the organization. Used for organizational purposes and displayed in various places throughout the system.
  - `navigating_to_job_uuid` string, uuid — UUID of the job the staff member is currently navigating to. Used to track which job a staff member is traveling toward.
  - `navigating_timestamp` string — The date and time when the staff member started navigating to a job. Format is YYYY-MM-DD HH:MM:SS. Used to track when navigation began.
  - `navigating_expiry_timestamp` string — The date and time when navigation to a job is expected to complete or expire. Format is YYYY-MM-DD HH:MM:SS. Used to determine if navigation is still active.
  - `color` string — The color assigned to this staff member, represented as a hex color code. Used for visual identification in the schedule, dispatch board, and other interfaces.
  - `custom_icon_url` unknown
  - `status_message` string — Short message summarising the staff's current status.
  - `status_message_timestamp` string — The date and time when the staff member's status message was last updated. Format is YYYY-MM-DD HH:MM:SS. Used to determine how recent the status message is.
  - `hide_from_schedule` 0 | 1 — Boolean flag controlling whether this staff member appears in the schedule view. When true (1), the staff member is hidden from the schedule. When false (0), they appear normally in scheduling interfaces.. Valid values are [0,1]
  - `uuid` string, uuid — Unique identifier for this record
  - `active` 0 | 1 — Record active/deleted flag. Valid values are [0,1]
  - `edit_date` string — Timestamp at which record was last modified
  - `can_receive_push_notification` string
  - `security_role_uuid` string, uuid
  - `labour_material_uuid` string, uuid

## Other responses

- `400` — Bad Request - The request is malformed or contains invalid parameters
- `401` — Unauthorized - Authentication credentials are missing or invalid
- `403` — Forbidden - You don't have permission to access this resource
- `429` — Too Many Requests - You have exceeded the rate limit
- `500` — Internal Server Error - An unexpected error occurred on the server

---

[API](https://skmtc.net/servicem8/apis/servicem8-api.md) · [All operations](https://skmtc.net/servicem8/apis/servicem8-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/servicem8/servicem8-api/versions/53ede60e3653/schema)