---
title: "List notes for a facility credentialing workflow"
method: GET
path: "/facility-credentialing-workflows/{workflowId}/notes"
tags: ["Facility Note"]
---

# List notes for a facility credentialing workflow

`GET /facility-credentialing-workflows/{workflowId}/notes`

Returns all notes attached to the specified facility credentialing workflow. Use this for the facility workflow note thread; for practitioner workflow notes use the Note endpoints.

Preconditions: workflowId must identify an existing facility credentialing workflow.

Important — query parameters with no current effect: filter, page, size, startAfterId, endAtId, and order are accepted for compatibility but are not applied by api-layer (not forwarded to the data layer). Results are returned in the order provided by the data layer (typically createdAt descending).

**Error behavior:** If the data layer returns a 5xx error, that status code is forwarded directly to the caller. Mutating operations (POST, PUT, DELETE) normalize 5xx to 502.

Returns a GetNotesResponse with totalCount, data, and links.

## Path parameters

- `workflowId` string, required

## Query parameters

- `endAtId` string
- `filter` string
- `order` string
- `page` integer
- `size` integer
- `startAfterId` string

## Headers

- `tenant-id` string, required

## Response `200`

Note list for the facility workflow (newest first); list query params are not applied

- GetNotesResponse — Response containing a list of notes
  - `totalCount` integer — Total count of notes returned for the workflow
  - `data` NoteResponse[] — Array of note records
    - `id` string — Unique identifier for the note
    - `workflowId` string — ID of the associated credentialing workflow
    - `data` NoteData — Note data containing message content
      - `message` string, required — The message content of the note
    - `createdBy` string — ID of the user who created the note
    - `createdByName` string — Full name of the user who created the note
    - `updatedBy` string — ID of the user who last updated the note
    - `updatedByName` string — Full name of the user who last updated the note
    - `createdAt` string, date-time
    - `updatedAt` string, date-time
  - `links` PageLinks1
    - `self` string
    - `next` string
    - `prev` string

## Other responses

- `401` — Unauthorized - Authentication required
- `403` — Forbidden - User does not have required permissions
- `404` — Facility credentialing workflow not found
- `500` — Internal Server Error - An unexpected error occurred
- `502` — Data-layer 5xx forwarded directly (not normalized to 502 as mutating ops are)

---

[API](https://skmtc.net/certifyos/apis/certify-api-layer.md) · [All operations](https://skmtc.net/certifyos/apis/certify-api-layer/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/certifyos/certify-api-layer/revisions/563848e0ecc0/schema)