---
title: "Find equipment downtimes based on search parameters. Deleted downtimes are not returned. Sort by `id`, `startDateTime`, `endDateTime` or `createdUtc`, ignoring case. Downtimes that tie on the sort field are ordered by `id` ascending. Without a sort field, results are ordered by creation date, newest first, whatever the sort direction."
method: POST
path: "/api/equipment-downtimes/list"
tags: ["Equipment Downtime"]
---

# Find equipment downtimes based on search parameters. Deleted downtimes are not returned. Sort by \`id\`, \`startDateTime\`, \`endDateTime\` or \`createdUtc\`, ignoring case. Downtimes that tie on the sort field are ordered by \`id\` ascending. Without a sort field, results are ordered by creation date, newest first, whatever the sort direction.

`POST /api/equipment-downtimes/list`

## Request

- Base URL: `https://api.fulcrumpro.com`
- URL: `https://api.fulcrumpro.com/api/equipment-downtimes/list`
- Auth: none declared

## Query parameters

- `Sort.Field` string
- `Sort.Dir` 'ascending' | 'descending': Specify sorting direction.
- `Skip` integer
- `Take` integer

## Request body

- EquipmentDowntimeRequestFindParameters: Parameters used for searching/finding equipment downtimes. Filters combine with AND.
  - `ids` string[], nullable: Filter downtimes to those with one of these ids.
  - `departmentIds` string[], nullable: Filter downtimes to those covering at least one of these departments.
  - `startsBeforeUtc` string, date-time, nullable: Filter downtimes that start before (exclusive) this time in UTC. If no time component is passed, midnight UTC will be used.
  - `endsAfterUtc` string, date-time, nullable: Filter downtimes that end after (exclusive) this time in UTC. If no time component is passed, midnight UTC will be used. Combine with `startsBeforeUtc` to find downtimes overlapping a window.

## Response `200`

List of equipment downtimes matching the filters

- EquipmentDowntimeDto[]
  - `id` string: Unique id of the downtime.
  - `startDateTime` string, date-time: When the downtime starts, in UTC.
  - `endDateTime` string, date-time: When the downtime ends, in UTC.
  - `departments` EquipmentDowntimeDepartmentDto[]: The departments that are down, in the order they were added. Empty when no department is assigned.
    - `departmentId` string, nullable: Id of the department.
    - `departmentName` string, nullable: Name of the department when it was added to the downtime.
    - `allEquipment` boolean: True when the whole department is down, which is when `equipment` is empty.
    - `equipment` EquipmentDowntimeEquipmentDto[]: The pieces of the department's equipment that are down, in the order they were added. Empty when the whole department is down.
      - `equipmentId` string, nullable: Id of the equipment.
      - `equipmentName` string, nullable: Name of the equipment when it was added to the downtime.
  - `deleted` boolean: Indicates whether this downtime has been deleted.

## Other responses

- `400`: The sort field, paging or filter parameters were invalid

## Changes

- **2026-10-05** `c3bdc499d639`: 8 breaking
  - the `departmentIds` request property's minItems was increased to `1` (media type: application/json-patch+json)
  - the `departmentIds` request property's minItems was increased to `1` (media type: application/json)
  - the `departmentIds` request property's minItems was increased to `1` (media type: text/json)
  - the `departmentIds` request property's minItems was increased to `1` (media type: application/*+json)
  - …4 more
- **2026-10-02** `125d94e06273`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/fulcrumpro/apis/fulcrum-publicapi/changes/api/equipment-downtimes/list/post.md)

---

[API](https://skmtc.dev/fulcrumpro/apis/fulcrum-publicapi.md) - [All operations](https://skmtc.dev/fulcrumpro/apis/fulcrum-publicapi/llms.txt) - [OpenAPI document](https://skmtc.dev/fulcrumpro/apis/fulcrum-publicapi/revisions/c9e6f41852d1?raw)
