---
title: "GET /jobs/{jobId}/phases"
method: GET
path: "/jobs/{jobId}/phases"
tags: ["Jobs"]
---

# GET /jobs/{jobId}/phases

`GET /jobs/{jobId}/phases`

## Request

- Base URL: `https://api.fergus.com`
- URL: `https://api.fergus.com/jobs/{jobId}/phases`
- Auth: one of:
  - OAuth 2
    - Authorization code: `https://auth.fergus.com/oauth2/authorize`
    - Token URL: `https://auth.fergus.com/oauth2/token`
  - HTTP bearer
- TypeScript: <https://skmtc.dev/fergus/apis/fergus-api/docs/jobs/:jobId/phases/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns a list of job phases.

Filterable fields:
- `filterStatus` — phase status, one of `To Schedule`, `To Start`, `In Progress`, `Labour Complete`, `To Invoice`, `To Be Approved`, `Invoiced`
- `filterUpdatedSince` — only phases updated at or after this ISO 8601 datetime

## Path parameters

- `jobId` number, required

## Query parameters

- `filterStatus` 'To Schedule' | 'To Start' | 'In Progress' | 'Labour Complete' | 'To Invoice' | 'To Be Approved' | 'Invoiced'
- `filterUpdatedSince` string, date-time

## Response `200`

Successful Response

- JobPhasesResponse
  - `result` string, required
  - `data` JobPhase[], required
    - `id` number, required
    - `jobId` number, required
    - `description` string, required
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, nullable, required
    - `title` string, required
    - `status` string, required
    - `assignedGroups` string[], required
    - `links` Links[], required
      - `href` string, required
      - `rel` string, required
      - `type` 'GET' | 'POST' | 'PUT' | 'PATCH', required

## Other responses

- `4XX`: Client Request Errors
- `5XX`: Server Errors

---

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