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

# List outreaches for a practitioner credentialing workflow

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

Returns all outreach records associated with a practitioner credentialing workflow, ordered by creation date descending. Use this to display the outreach history for a single practitioner workflow; for facility workflows, use the facility-specific outreach endpoint instead. `workflowId` must be a practitioner credentialing workflow ID obtainable from the workflow management APIs - an unrecognized workflowId returns an empty list rather than a 404. The response is a PractitionerOutreachListResponse envelope; `page` and `size` are currently fixed at 0 and 100 respectively (pagination is not yet supported), so a workflow with more than 100 outreaches will not return the remainder.

## Path parameters

- `workflowId` string, required

## Headers

- `tenant-id` string, required

## Response `200`

A PractitionerOutreachListResponse envelope containing the outreach records for this workflow (each with attemptsCount, workflowStatus, and enriched reasons), totalCount, and the fixed page/size values.

- 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` — Unauthorized - Authentication required
- `403` — Forbidden - User does not have required permissions
- `500` — Internal Server Error - An unexpected error occurred. The body is a plain string, not the ApiError shape.

---

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