---
title: "Lists the operations of several jobs, one row per job ordered by job id. The page size counts jobs. Each row's operations are exactly what the single-job operation list returns for that job when the job is not deleted."
method: POST
path: "/api/jobs/operations/list"
tags: ["Job Operation"]
---

# Lists the operations of several jobs, one row per job ordered by job id. The page size counts jobs. Each row's operations are exactly what the single-job operation list returns for that job when the job is not deleted.

`POST /api/jobs/operations/list`

## Request

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

Deleted jobs are left out: they return no row and do not count toward the total.

## Query parameters

- `skip` integer
- `take` integer

## Request body

- JobRequestListByJobsParameters: Parameters for reading a per-job list for several jobs in one paged list.
  - `jobIds` string[], required: The jobs to list. Deleted jobs are left out; unknown ids contribute no rows.

## Response `200`

A page of jobs with their operations

- DtoPagedResultDtoJobOperationsRowDto: Paged result
  - `data` JobOperationsRowDto[], required: The data
    - `jobId` string: The job these operations belong to.
    - `operations` JobTrackingOperationDetailsDto[]: The job's operations, as the single-job operation list returns them. Empty when the job has none.
      - `itemToMake` JobTrackingItemToMakeDto, required: Represents an item to make on a job (for tracking purposes)
        - `id` string, required: Unique Id associated to this entity
        - `itemId` string, required: Id of the item on which this entity is based. Please reference /api/items endpoint.
        - `quantityToMake` number, double, required: Quantity of this item produced by the associated job.
        - `isCustom` boolean, required: Denotes whether this job produces a customized version of the base item
        - `status` 'new' | 'working' | 'complete' | 'cancelled', required: Job Item to Make status
        - `quantityMade` number, double, nullable: Quantity already produced, if the job is in progress.
        - `depth` integer, required: Structurally, identify where in the tree of building the parent item this item lies. Example: The top-level item would have a depth of zero and it's direct subcomponents would be 1. This cascades down so that a subcomponent to a subcomponent would be 2... and so on.
        - `parentItemToMakeIds` string[], nullable: Ids of the items to make on this job that consume this one. Items to make exist once the job is approved; before that, the list is empty. Empty for the job's primary part and null for an item the job does not link to a parent. A shared subcomponent lists every parent. Null on job tracking responses.
        - `routingNotes` string, nullable: The routing notes (the "Routing Notes" field) captured on this job's routing for the item. Null when the job's routing has no note for the item.
        - `costBreakdown` CommonCostBreakdownDto: Cost breakdown
          - `id` string, required: The id of the parent item.
          - `type` 'estimated' | 'inProgressJob' | 'completedJob' | 'cancelledJob', required
          - `quantity` integer, required: Number of units.
          - `quantityScrapped` integer, nullable: Number of units scrapped.
          - `calculatedOn` string, date-time, required: When was this cost breakdown last calculated/aggregated.
          - `time` CommonTimeDto, required: Time information
            - `labor` number, double, required: Total
            - `machine` number, double, required: Cost per unit
            - `setup` number, double, required: Cost per unit
          - `cumulative` CommonCostDto, required: Cost information
            - `total` number, double, required: Total
            - `perUnit` number, double, required: Cost per unit
          - `cumulativeMaterial` CommonCostDto, required: Cost information
            - `total` number, double, required: Total
            - `perUnit` number, double, required: Cost per unit
          - `cumulativeLabor` CommonCostDto, required: Cost information
            - `total` number, double, required: Total
            - `perUnit` number, double, required: Cost per unit
          - `cumulativeMachine` CommonCostDto, required: Cost information
            - `total` number, double, required: Total
            - `perUnit` number, double, required: Cost per unit
          - `cumulativeOutsideProcessing` CommonCostDto, required: Cost information
            - `total` number, double, required: Total
            - `perUnit` number, double, required: Cost per unit
          - `itemMaterial` CommonCostDto, required: Cost information
            - `total` number, double, required: Total
            - `perUnit` number, double, required: Cost per unit
          - `itemLabor` CommonCostDto, required: Cost information
            - `total` number, double, required: Total
            - `perUnit` number, double, required: Cost per unit
          - `itemMachine` CommonCostDto, required: Cost information
            - `total` number, double, required: Total
            - `perUnit` number, double, required: Cost per unit
          - `itemOutsideProcessing` CommonCostDto, required: Cost information
            - `total` number, double, required: Total
            - `perUnit` number, double, required: Cost per unit
          - `shopRateSetup` CommonCostDto, required: Cost information
            - `total` number, double, required: Total
            - `perUnit` number, double, required: Cost per unit
          - `shopRateRun` CommonCostDto, required: Cost information
            - `total` number, double, required: Total
            - `perUnit` number, double, required: Cost per unit
          - `shopRateMachine` CommonCostDto, required: Cost information
            - `total` number, double, required: Total
            - `perUnit` number, double, required: Cost per unit
          - `componentMaterial` CommonCostDto, required: Cost information
            - `total` number, double, required: Total
            - `perUnit` number, double, required: Cost per unit
          - `componentLabor` CommonCostDto, required: Cost information
            - `total` number, double, required: Total
            - `perUnit` number, double, required: Cost per unit
          - `componentMachine` CommonCostDto, required: Cost information
            - `total` number, double, required: Total
            - `perUnit` number, double, required: Cost per unit
          - `componentOutsideProcessing` CommonCostDto, required: Cost information
            - `total` number, double, required: Total
            - `perUnit` number, double, required: Cost per unit
          - `lines` CommonCostBreakdownLineDto[], required: Cost breakdown line details.
            - `costType` 'material' | 'labor' | 'setup' | 'machine' | 'outsideProcessing' | 'componentMaterial' | 'componentLabor' | 'componentMachine' | 'componentOutsideProcessing' | 'nestPartMaterialUsage' | 'nestPartMaterialScrap' | 'overhead' | 'unknown', required: Cost breakdown types
            - `operationType` 'labor' | 'setup' | 'machine' | 'outsideProcessing': Operation type
            - `name` string, required: Decription of this line.
            - `cost` number, double, required: Cost.
            - `quantity` number, double, nullable: Quantity (if applicable)
            - `itemId` string, nullable: Id of the item that was picked. Please reference /api/items endpoint.
            - `itemName` string, nullable: The name of the item that was picked.
            - `accountingCodeId` string, nullable: Accounting code affected. Please reference /api/accounting-codes endpoint.
            - `operationInformation` CommonCostBreakdownOperationDto: Operation information
              - …
        - `costBreakdownEstimated` CommonCostBreakdownDto: Cost breakdown
          - `id` string, required: The id of the parent item.
          - `type` 'estimated' | 'inProgressJob' | 'completedJob' | 'cancelledJob', required
          - `quantity` integer, required: Number of units.
          - `quantityScrapped` integer, nullable: Number of units scrapped.
          - `calculatedOn` string, date-time, required: When was this cost breakdown last calculated/aggregated.
          - `time` CommonTimeDto, required: Time information
            - `labor` number, double, required: Total
            - `machine` number, double, required: Cost per unit
            - `setup` number, double, required: Cost per unit
          - `cumulative` CommonCostDto, required: Cost information
            - `total` number, double, required: Total
            - `perUnit` number, double, required: Cost per unit
          - `cumulativeMaterial` CommonCostDto, required: Cost information
            - `total` number, double, required: Total
            - `perUnit` number, double, required: Cost per unit
          - `cumulativeLabor` CommonCostDto, required: Cost information
            - `total` number, double, required: Total
            - `perUnit` number, double, required: Cost per unit
          - `cumulativeMachine` CommonCostDto, required: Cost information
            - `total` number, double, required: Total
            - `perUnit` number, double, required: Cost per unit
          - `cumulativeOutsideProcessing` CommonCostDto, required: Cost information
            - `total` number, double, required: Total
            - `perUnit` number, double, required: Cost per unit
          - `itemMaterial` CommonCostDto, required: Cost information
            - `total` number, double, required: Total
            - `perUnit` number, double, required: Cost per unit
          - `itemLabor` CommonCostDto, required: Cost information
            - `total` number, double, required: Total
            - `perUnit` number, double, required: Cost per unit
          - `itemMachine` CommonCostDto, required: Cost information
            - `total` number, double, required: Total
            - `perUnit` number, double, required: Cost per unit
          - `itemOutsideProcessing` CommonCostDto, required: Cost information
            - `total` number, double, required: Total
            - `perUnit` number, double, required: Cost per unit
          - `shopRateSetup` CommonCostDto, required: Cost information
            - `total` number, double, required: Total
            - `perUnit` number, double, required: Cost per unit
          - `shopRateRun` CommonCostDto, required: Cost information
            - `total` number, double, required: Total
            - `perUnit` number, double, required: Cost per unit
          - `shopRateMachine` CommonCostDto, required: Cost information
            - `total` number, double, required: Total
            - `perUnit` number, double, required: Cost per unit
          - `componentMaterial` CommonCostDto, required: Cost information
            - `total` number, double, required: Total
            - `perUnit` number, double, required: Cost per unit
          - `componentLabor` CommonCostDto, required: Cost information
            - `total` number, double, required: Total
            - `perUnit` number, double, required: Cost per unit
          - `componentMachine` CommonCostDto, required: Cost information
            - `total` number, double, required: Total
            - `perUnit` number, double, required: Cost per unit
          - `componentOutsideProcessing` CommonCostDto, required: Cost information
            - `total` number, double, required: Total
            - `perUnit` number, double, required: Cost per unit
          - `lines` CommonCostBreakdownLineDto[], required: Cost breakdown line details.
            - `costType` 'material' | 'labor' | 'setup' | 'machine' | 'outsideProcessing' | 'componentMaterial' | 'componentLabor' | 'componentMachine' | 'componentOutsideProcessing' | 'nestPartMaterialUsage' | 'nestPartMaterialScrap' | 'overhead' | 'unknown', required: Cost breakdown types
            - `operationType` 'labor' | 'setup' | 'machine' | 'outsideProcessing': Operation type
            - `name` string, required: Decription of this line.
            - `cost` number, double, required: Cost.
            - `quantity` number, double, nullable: Quantity (if applicable)
            - `itemId` string, nullable: Id of the item that was picked. Please reference /api/items endpoint.
            - `itemName` string, nullable: The name of the item that was picked.
            - `accountingCodeId` string, nullable: Accounting code affected. Please reference /api/accounting-codes endpoint.
            - `operationInformation` CommonCostBreakdownOperationDto: Operation information
              - …
        - `itemReference` ItemReferenceDto: Item reference
          - `id` string, required: Unique Id associated to this entity
          - `number` string: Item number.
          - `revision` string, nullable: Revision name.
          - `name` string, nullable: Item name.
          - `description` string, nullable: Item description.
      - `operation` JobTrackingOperationDto, required: Represents a job operation (for tracking purposes).
        - `id` string, required: Unique Id associated to this entity
        - `status` 'pending' | 'ready' | 'running' | 'paused' | 'complete' | 'cancelled', required: Job Item to Make Operation status
        - `order` integer, required: Routing order of the operation
        - `systemOperationId` string, required: Identifier of the system operation associated to this entity Please reference api/operations.
        - `isOutsideProcessing` boolean, required: Denotes whether this is an outside processing operation
        - `originalScheduledStartUtc` string, date-time, nullable: The first scheduled start time.
        - `originalScheduledEndUtc` string, date-time, nullable: The first scheduled end time.
        - `scheduledStartUtc` string, date-time, nullable: Scheduled start datetime of the operation
        - `scheduledEndUtc` string, date-time, nullable: Scheduled end datetime of the operation
        - `completedOnUtc` string, date-time, nullable: The operation completion datetime.
        - `completedById` string, nullable: Operation completed user identifier. Please reference /api/users endpoint.
        - `scheduledEquipmentId` string, nullable: Identifier of the equipment that this operation is scheduled to run on
        - `scheduledEquipmentName` string, nullable: The name of the equipment that this operation is scheduled to run on.
        - `customFields` object, nullable: The custom field data on the object
        - `instructions` string, nullable: Instructions specific to the item to make operation.
        - `name` string, nullable: System operation name.
        - `leadTimeInDays` integer, nullable: Number of days required between order and receipt. Only applicable for outside processing operations.
        - `associatedPurchaseOrderIds` string[], nullable: Associated purchase order IDs.
        - `estimatedSetupTimeInSeconds` number, double, nullable: The estimated setup time in seconds for the operation.
        - `estimatedSetupTimeBasis` 'fixed' | 'perUnit'
        - `estimatedRunTimeInSeconds` number, double, nullable: The estimated run time in seconds for the operation. Note: This is an obsolete field from when operation could not separate between machine (unattended) and labor (attended) time.
        - `estimatedRunTimeBasis` 'fixed' | 'perUnit' | 'unitsPerHour'
        - `estimatedMachineTimeInSeconds` number, double, nullable: The estimated machine time in seconds for the operation.
        - `estimatedMachineTimeBasis` 'fixed' | 'perUnit' | 'unitsPerHour'
        - `estimatedLaborTimeInSeconds` number, double, nullable: The estimated labor time in seconds for the operation.
        - `estimatedLaborTimeBasis` 'fixed' | 'perUnit' | 'unitsPerHour'
        - `routingStepId` string, nullable: Identifier of the job routing step this operation was built from: the `id` of an operation in the job's routing operations list (jobs/{jobId}/routing/{routingId}/operations/list). Null when the operation has no routing step. `setupTime`, `laborTime` and `machineTime` describe that routing step, not this operation: they are the same on every piece of a split operation and can differ from this operation's own estimates. Each is null when this is null, when the step is no longer on the job's routing, when the step is outside processing, or when the step has no value for that timer.
        - `setupTime` ItemRoutingOperationTime: Operation time and type
          - `time` number, double: Time or units of this operation
          - `option` 'fixedSeconds' | 'fixedMinutes' | 'fixedHours' | 'fixedDays' | 'secondsPerUnit' | 'minutesPerUnit' | 'hoursPerUnit' | 'daysPerUnit' | 'unitsPerHour': The time unit or option used in operation times
        - `laborTime` ItemRoutingOperationTime: Operation time and type
          - `time` number, double: Time or units of this operation
          - `option` 'fixedSeconds' | 'fixedMinutes' | 'fixedHours' | 'fixedDays' | 'secondsPerUnit' | 'minutesPerUnit' | 'hoursPerUnit' | 'daysPerUnit' | 'unitsPerHour': The time unit or option used in operation times
        - `machineTime` ItemRoutingOperationTime: Operation time and type
          - `time` number, double: Time or units of this operation
          - `option` 'fixedSeconds' | 'fixedMinutes' | 'fixedHours' | 'fixedDays' | 'secondsPerUnit' | 'minutesPerUnit' | 'hoursPerUnit' | 'daysPerUnit' | 'unitsPerHour': The time unit or option used in operation times
        - `isMachineTimeOnly` boolean: Whether this operation can be run without an employee present. If true, use the machineTime properties. If false, use the laborTime properties.
        - `workOrderId` string, nullable: Identifier of work order that this operation is associated to, if applicable. Please reference api/work-orders endpoint.
        - `quantityToMake` number, double: Quantity this operation is expected to produce. Read-only: returned on operation reads but not settable through the update endpoints.
        - `quantityCompleted` number, double: Quantity already completed on this operation, if the job is in progress. Read-only: returned on operation reads but not settable through the update endpoints.
        - `quantityMade` number, double: Quantity recorded as made on this operation: stamped when the operation completes, and banked through receiving on an outside-processing operation. Unlike FulcrumProduct.PublicApi.Dto.Job.ItemToMake.Operation.OperationDto.QuantityCompleted, it does not include the running count banked while the operation is in progress. Read-only: returned on operation reads but not settable through the update endpoints.
        - `excludeSetupTimeFromAudit` boolean: Whether this operation's setup time is left out of the routing audit's job-history averages. Read-only: returned on operation reads but not settable through the update endpoints.
        - `excludeLaborTimeFromAudit` boolean: Whether this operation's labor time is left out of the routing audit's job-history averages. Read-only: returned on operation reads but not settable through the update endpoints.
        - `excludeMachineTimeFromAudit` boolean: Whether this operation's machine time is left out of the routing audit's job-history averages. Read-only: returned on operation reads but not settable through the update endpoints.
        - `isRework` boolean: Whether this operation is a rework operation (a redo created from a prior operation).
        - `hasAssociatedRework` boolean: Whether this operation was sent for rework (one or more rework operations were created from it).
        - `rework` JobTrackingOperationReworkDto: Rework details associated with a job operation.
          - `reasonId` string, nullable: Identifier of the rework reason.
          - `reason` string, nullable: The rework reason.
          - `notes` string, nullable: Free-text notes captured when the rework was recorded.
          - `quantityToRework` integer: The quantity sent for rework.
          - `quantityScrapped` integer: The quantity scrapped as part of the rework.
          - `hasScrapMaterials` boolean: Whether scrap materials were tracked as part of the rework.
          - `createdByUserId` string, nullable: Identifier of the user who recorded the rework. Please reference /api/users endpoint.
          - `createdUtc` string, date-time: The datetime the rework was recorded.
  - `page` integer, required: The 1-indexed page
  - `pageSize` integer, required: The page size
  - `totalCount` integer, required: The total count of records
  - `totalPages` integer, required: The total pages
  - `hasPreviousPage` boolean, required: True if there is a previous page
  - `hasNextPage` boolean, required: True if there is a next page

## Changes

- **2026-11-14** `7a73a80a6afb`: 1 info
  - endpoint added

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