---
title: "Retrieve Work Order Status"
method: GET
path: "/work_order_statuses/{id}"
tags: ["Work Order Statuses"]
---

# Retrieve Work Order Status

`GET /work_order_statuses/{id}`

## Request

- Base URL: `https://secure.fleetio.com/api`
- URL: `https://secure.fleetio.com/api/work_order_statuses/{id}`
- Auth: API key in header `Authorization` and API key in header `Account-Token`
- TypeScript: <https://skmtc.dev/fleetio/apis/fleetio-developer-api/docs/work_order_statuses/:id/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve the details of an existing Work Order Status.

## Path parameters

- `id` string, required

## Response `200`

OK

- WorkOrderStatus: A Work Order Status
  - `id` integer
  - `created_at` string, date-time: The date and time at which this record was created.
  - `updated_at` string, date-time: The date and time at which this record was most recently updated.
  - `account_id` integer, required
  - `name` string, required: The name of the Work Order Status.
  - `description` string, nullable, required: The description of the Work Order Status.
  - `color` string, nullable, required: The color of the Work Order Status seen in the UI.
  - `default` boolean, required: Whether or not this is the default Work Order Status applied to new `Work Orders`.
  - `completed` boolean, required: Whether Work Orders will be set to `completed` when they are moved to this status.
  - `position` integer, required: The position of this Work Order Status in the list of statuses.
  - `work_orders_count` integer, required: The number of `Work Orders` that are currently in this status.

## Other responses

- `401`: Request could not be authenticated
- `403`: Insufficient permission to perform this operation
- `404`: The requested resource could not be located
- `500`: Something unexpected happened

---

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