---
title: "Find the job-tracking alerts that are currently raised, on job operations and work-order operations, based on search parameters. An alert raised on a job operation that is grouped into a work order is stored against the work-order operation, so it is a `workOrder` alert: filter on `workOrderIds`, not `jobIds`, to find it. Cleared alerts are not returned, nor are alerts on a deleted job or work order, or on an operation, job or work order that is Complete or Cancelled. Sort by `raisedAtUtc` or `id`, ignoring case. Alerts that tie on `raisedAtUtc` are ordered by `id` ascending. Without a sort field, results are ordered by `raisedAtUtc`, oldest first, and the sort direction is honored."
method: POST
path: "/api/alerts/list"
tags: ["Alert"]
---

# Find the job-tracking alerts that are currently raised, on job operations and work-order operations, based on search parameters. An alert raised on a job operation that is grouped into a work order is stored against the work-order operation, so it is a \`workOrder\` alert: filter on \`workOrderIds\`, not \`jobIds\`, to find it. Cleared alerts are not returned, nor are alerts on a deleted job or work order, or on an operation, job or work order that is Complete or Cancelled. Sort by \`raisedAtUtc\` or \`id\`, ignoring case. Alerts that tie on \`raisedAtUtc\` are ordered by \`id\` ascending. Without a sort field, results are ordered by \`raisedAtUtc\`, oldest first, and the sort direction is honored.

`POST /api/alerts/list`

## Request

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

## Query parameters

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

## Request body

- AlertRequestFindParameters: Parameters used for searching/finding active job-tracking alerts. Filters combine with AND.
  - `jobIds` string[], nullable: Filter alerts to those raised on an operation of one of these jobs.
  - `workOrderIds` string[], nullable: Filter alerts to those raised on an operation of one of these work orders.
  - `workCenterIds` string[], nullable: Filter alerts to those raised on an operation scheduled to one of these work centers.
  - `equipmentIds` string[], nullable: Filter alerts to those raised on an operation scheduled to one of these pieces of equipment.
  - `alertNames` string[], nullable: Filter alerts to those with one of these alert names.
  - `raisedAfterUtc` string, date-time, nullable: Filter alerts raised after (exclusive) this time in UTC. If no time component is passed, midnight UTC will be used.
  - `raisedBeforeUtc` string, date-time, nullable: Filter alerts raised before (exclusive) this time in UTC. If no time component is passed, midnight UTC will be used.

## Response `200`

List of active alerts matching the filters

- AlertDto[]
  - `id` integer: Unique id of the alert.
  - `alertName` string, nullable: The alert type's name, as configured in the job-tracking alert settings.
  - `active` boolean: Whether the alert is raised. A cleared alert is removed and no longer listed.
  - `raisedAtUtc` string, date-time: When the alert was raised, in UTC.
  - `source` 'job' | 'workOrder': What a job-tracking alert was raised on.
  - `job` AlertJobDto: The job an alerted operation belongs to.
    - `id` string: Unique id of the job.
    - `number` integer: The job number.
    - `name` string, nullable: The job name.
  - `itemToMake` AlertItemToMakeDto: The job item to make an alerted operation belongs to.
    - `id` string, nullable: Unique id of the item to make within its job.
    - `itemId` string, nullable: Id of the item being made.
    - `itemName` string, nullable: Name of the item being made.
    - `itemNumber` string, nullable: Number of the item being made.
  - `workOrder` AlertWorkOrderDto: The work order an alerted operation belongs to.
    - `id` string: Unique id of the work order.
    - `number` integer: The work order number.
    - `name` string, nullable: The work order name.
  - `operation` AlertOperationDto: The operation an alert was raised on.
    - `id` string, nullable: Unique id of the job operation, or of the work-order operation when the alert's source is `workOrder`.
    - `name` string, nullable: The operation name.
    - `workCenter` AlertReferenceDto: An id and name reference on an alerted operation.
      - `id` string: Unique id.
      - `name` string, nullable: Name.
    - `equipment` AlertReferenceDto: An id and name reference on an alerted operation.
      - `id` string: Unique id.
      - `name` string, nullable: Name.

## Other responses

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

## Changes

- **2026-10-09** `efbedf8e5e19`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/fulcrumpro/apis/fulcrum-publicapi/changes/api/alerts/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)