---
title: "List the chat messages on a job, newest first. Omit the body (or both ids) for the job-level chat; supply itemToMakeId and operationId together for one operation's chat."
method: POST
path: "/api/jobs/{jobId}/messages/list"
tags: ["Job Message"]
---

# List the chat messages on a job, newest first. Omit the body (or both ids) for the job-level chat; supply itemToMakeId and operationId together for one operation's chat.

`POST /api/jobs/{jobId}/messages/list`

## Path parameters

- `jobId` string, required

## Query parameters

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

## Request body

- MessageRequestListJobMessagesParameters — Selects which chat on the job to list. Omit both ids for the job-level chat; supply both for one operation's chat.
  - `itemToMakeId` string, nullable — Id of the item-to-make whose operation chat to list. Must be supplied together with operationId.
  - `operationId` string, nullable — Id of the operation whose chat to list. Must be supplied together with itemToMakeId.

## Response `200`

The page of messages; an empty page when the chat has no messages yet

- DtoPagedResultDtoJobMessageDto — Paged result
  - `data` JobMessageDto[], required — The data
    - `id` string, required — Unique id of the message
    - `jobId` string, required — Id of the job the message was posted on
    - `itemToMakeId` string, nullable — Id of the item-to-make the message was posted on; null for a job-level message
    - `operationId` string, nullable — Id of the operation the message was posted on; null for a job-level message
    - `body` string, nullable — Message text
    - `mentions` string[], required — Ids of the users @mentioned in the message. Please reference /api/users endpoints.
    - `createdUtc` string, date-time, required — When the message was posted
    - `createdBy` CommonReferenceDto — Represents a reference to a document in a DB collection
      - `id` string, nullable — Unique Id associated to the referenced object
      - `name` string, nullable — Descriptive name associated to the object
    - `modifiedUtc` string, date-time, nullable — When the message was last edited
  - `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

## Other responses

- `400` — itemToMakeId and operationId were not supplied together, or a sort was requested
- `404` — Job did not exist, or the operation is not on that item-to-make of the job

## Changes

- **2026-09-11** `c00251431237` — 1 info
  - endpoint added

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