---
title: "Get latest facility timeline events for facility credentialing workflows"
method: GET
path: "/facility-credentialing-workflows/timeline-events/latest"
tags: ["FacilityCredentialingWorkflow"]
---

# Get latest facility timeline events for facility credentialing workflows

`GET /facility-credentialing-workflows/timeline-events/latest`

Returns the most recent facility timeline event (by creation date) for each requested facility credentialing workflow ID, including data.changeReason when present. Accepts 1–10 workflow IDs. If a workflow has no timeline events, that ID is still included with an error message; other IDs are unaffected (partial success).

## Query parameters

- `workflowIds` unknown[], required
  - unknown

## Headers

- `tenant-id` string, required

## Response `200`

Successfully retrieved latest facility timeline events (may include per-ID error entries)

- GetLatestFacilityTimelineEventsResponse — Response containing the latest facility timeline event (or error) for each requested workflow ID
  - `results` LatestFacilityTimelineEventResult[] — Per-workflow latest facility timeline event results
    - `workflowId` string — Facility credentialing workflow ID
    - `timelineEvent` FacilityTimelineEventResponse
      - `id` string
      - `workflowId` string
      - `createdBy` string
      - `createdAt` string, date
      - `updatedAt` string, date
      - `updatedBy` string
      - `data` FacilityTimelineEventschema
        - `credentialingDecisionDate` string, date, required
        - `nextCredentialingDate` string, date, required
        - `nextCredentialingDateSource` 'SYSTEM_CALCULATED' | 'USER_INPUT'
        - `changeReason` string, required
        - `psvPdfPath` string
        - `nextCredentialingDateChangeLog` FacilityCredApprovedNextCredentialingDateChangeLogInner[]
          - `changedFrom` string, date, required
          - `changedTo` string, date, required
          - `changeReason` string, required
          - `createdBy` string, required
          - `createdAt` string, date, required
        - `isOverride` boolean
        - `overrideReason` string
    - `errorMessage` string — Error message when the latest timeline event is missing or unavailable

## Other responses

- `400` — Invalid request parameters (empty, blank, or more than 10 unique workflowIds)
- `401` — Unauthorized - Authentication required
- `403` — Forbidden - User does not have required permissions
- `404` — Not Found - One or more workflows not found or not owned by the tenant
- `500` — Internal Server Error - An unexpected error occurred

---

[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)