---
title: "List all outreaches for a facility workflow"
method: GET
path: "/facility-credentialing-outreaches/workflow/{workflowId}"
tags: ["Facility Credentialing Outreach Resource"]
---

# List all outreaches for a facility workflow

`GET /facility-credentialing-outreaches/workflow/{workflowId}`

Returns a paginated list of every credentialing outreach sent for the given facility credentialing workflow. Use it to render outreach history for a facility workflow, or to obtain an outreachId to pass to the outreach detail endpoint. workflowId must be a facility credentialing workflow ID, not a practitioner credentialing workflow ID - supplying a practitioner workflow ID returns an empty list rather than an error, since an unrecognized workflowId is treated as having no outreaches. Pagination is currently hardcoded to page 0 and size 100 and cannot be changed by the caller; if a workflow has more than 100 outreaches, only the first 100 are returned and the rest are silently omitted. The response envelope (PractitionerOutreachListResponse) is reused verbatim from the practitioner outreach endpoints - its field names refer to practitioners for historical reasons, but it carries facility outreach records here.

## Path parameters

- `workflowId` string, required

## Headers

- `tenant-id` string, required

## Response `200`

A paginated envelope of outreach records for this facility workflow: data (the outreach records, each with attemptsCount and workflowStatus), totalCount (total matching records), and the fixed page (always 0) and size (always 100).

- PractitionerOutreachListResponse — Paginated envelope of outreach records for a practitioner or facility credentialing workflow
  - `data` PractitionerOutreachItem[] — Outreach records for this workflow, ordered by creation date descending
    - `id` string — Outreach record ID
    - `tenantId` string — Tenant that owns this outreach record
    - `workflowId` string — Credentialing workflow (practitioner or facility) this outreach was sent for
    - `outreachType` 'PRACTITIONER_CREDENTIALING' | 'FACILITY_CREDENTIALING' | 'PRACTITIONER_MONITORING' — Outreach category this record was created for
    - `reasons` OutreachReasonWithLabel[] — Outreach reasons with their display labels
      - `id` string — Unique identifier for the outreach reason
      - `label` string — Display label for the outreach reason
    - `active` boolean — Whether this outreach is still open/awaiting a response
    - `attemptsCount` integer — Number of outreach emails sent for this record
    - `lastAttemptedAt` string, date-time
    - `workflowStatus` string — Status of the referenced credentialing workflow at the time of this response
    - `createdBy` string — User ID that created this outreach record
    - `createdByName` string — Display name of the user that created this outreach record
    - `createdAt` string, date-time
    - `updatedAt` string, date-time
  - `totalCount` integer — Total number of outreach records matching this workflow
  - `page` integer — Current page index. Always 0 - pagination is not yet supported
  - `size` integer — Page size. Always 100 - a hardcoded ceiling; records beyond this are not returned

## Other responses

- `401` — The request has no valid authentication token.
- `403` — The caller lacks the credentialing-outreach:read permission required to list facility outreaches.
- `500` — An unexpected error occurred while fetching the outreach history for this workflow.

---

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