---
title: "List of credentialing workflows"
method: GET
path: "/credentialing-workflows"
tags: ["credentialing-workflows"]
---

# List of credentialing workflows

`GET /credentialing-workflows`

Returns a paginated list of credentialing workflows for the organization.

## Query parameters

- `offset` number
- `limit` number
- `providerNpi` string
- `providerFirstName` string
- `providerLastName` string
- `providerType` string
- `providerFileType` string
- `providerState` string
- `providerStates` array[]
  - unknown[]
    - unknown
- `providerAssignedStates` array[]
  - unknown[]
    - unknown
- `name` string
- `onStep` string
- `outreachReasons` array[]
  - unknown[]
    - unknown
- `createdAtStart` string, date-time
- `createdAtEnd` string, date-time
- `nextCredentialingStart` string, date-time
- `nextCredentialingEnd` string, date-time
- `credentialingCycle` 'Initial' | 'Recredentialing'
- `completedAtStart` string, date-time
- `completedAtEnd` string, date-time
- `credentialingStatusUpdatedAtStart` string, date-time
- `credentialingStatusUpdatedAtEnd` string, date-time
- `psvCompleteDateStart` string, date-time
- `workflowIds` array[]
  - unknown[]
    - unknown
- `assignedTo` string
- `includeTerminatedProviders` boolean
- `providerExternalId` string
- `locationType` 'primaryCare' | 'specialtyCare' | 'behavioralHealth' | 'urgentCare' | 'surgicalServices' | 'rehabilitationServices' | 'laboratoryServices' | 'imagingServices' | 'longTermCare' | 'hospiceOrPalliativeCare' | 'homeHealthServices' | 'others'
- `orgEntityIds` array[]
  - unknown[]
    - unknown
- `providerOrgEntityIds` array[]
  - unknown[]
    - unknown

## Headers

- `organization-id` string

## Response `200`

Paginated list of credentialing workflows.

- PaginatedCredentialingWorkflowsResponseDto
  - `data` CredentialingWorkflowListItemDto[], required — List of credentialing workflows for the organization, with optional provider data attached.
    - `id` string
    - `name` string
    - `organizationId` string
    - `providerId` string
    - `providerNpi` string
    - `providerFirstName` string
    - `providerLastName` string
    - `providerType` string
    - `providerFileType` string
    - `providerStatus` string
    - `providerStates` string[]
    - `providerAssignedStates` string[]
    - `providerExternalId` string
    - `onStep` CredentialingWorkflowOnStepDto
      - `title` string, required — Step title
    - `assignment` CredentialingWorkflowAssignmentDto
      - `assignedToFirstName` string
      - `assignedToLastName` string
      - `assignedToId` string
      - `assignedByFirstName` string
      - `assignedByLastName` string
      - `assignedById` string
      - `assignedOn` string, nullable — ISO date string or null when unassigned.
      - `lastActivity` string, nullable — ISO date string or null.
    - `isCompleted` boolean
    - `completedAt` object
    - `credentialingStatusUpdatedAt` object — ISO date string or Firestore Timestamp object { _seconds, _nanoseconds }.
    - `credentialingCycle` string
    - `orgEntity` CredentialingWorkflowOrgEntityDto
      - `id` string
      - `name` string
    - `providerOrgEntities` string[]
    - `createdAt` object — ISO date string or Firestore Timestamp object { _seconds, _nanoseconds }.
    - `createdBy` string
    - `createdByName` string, nullable
    - `normalizedDocumentId` string
    - `updatedBy` string
    - `updatedAt` object — ISO date string or Firestore Timestamp object { _seconds, _nanoseconds }.
    - `credentialingWorkflowTimeline` CredentialingWorkflowTimelineSummaryDto
      - `credentialingStatus` string
      - `createdBy` string
      - `createdByName` string, nullable
      - `credentialingDecisionDate` object
      - `medicalDirectorId` string, nullable
      - `psvCompleteDate` object
      - `verifierId` string
      - `updatedBy` string
      - `attestationDate` object
      - `updatedByName` string, nullable
      - `medicalDirectorName` string, nullable
      - `nextCredentialingDate` object
      - `initialCredentialingDate` object
      - `lastCredentialedDate` object
      - `receivedForCredentialingDate` object
      - `updatedAt` object
    - `provider` AttachedProviderSummaryDto
      - `id` string
      - `organizationId` string
      - `providerId` string
      - `firstName` string
      - `lastName` string
      - `npi` string
      - `providerType` string
      - `credentialingStatus` string
      - `status` string
      - `credentialingTimelineAggregate` CredentialingTimelineAggregateDto
        - `newestNextCredentialingDate` object — Newest next credentialing date, or null.
        - `oldestLastCredentialedDate` object — Oldest last credentialed date, or null.
        - `oldestNextCredentialingDate` object — Oldest next credentialing date, or null.
        - `newestLastCredentialedDate` object — Newest last credentialed date, or null.
        - `credentialingStatuses` array[] — List of credentialing statuses from timelines.
          - unknown[]
            - unknown
      - `credentialingWorkflowTimeline` CredentialingWorkflowTimelineSummaryDto
        - `credentialingStatus` string
        - `createdBy` string
        - `createdByName` string, nullable
        - `credentialingDecisionDate` object
        - `medicalDirectorId` string, nullable
        - `psvCompleteDate` object
        - `verifierId` string
        - `updatedBy` string
        - `attestationDate` object
        - `updatedByName` string, nullable
        - `medicalDirectorName` string, nullable
        - `nextCredentialingDate` object
        - `initialCredentialingDate` object
        - `lastCredentialedDate` object
        - `receivedForCredentialingDate` object
        - `updatedAt` object
    - `elapsedTime` number — Elapsed time in milliseconds for the workflow.
    - `outreachReasons` string[]
    - `version` number
    - `lastOutreachDate` string
    - `outreachAttempts` number
    - `daysToCompletion` number
    - `clientSlaDays` number
    - `psvGenerated` boolean
    - `psvFileSignedUrl` string
    - `psvFileGenerationErrors` string[]
  - `count` number, required — Total number of credentialing workflows matching the filter (for pagination).

## Other responses

- `400` — Bad request. Missing or invalid `organization-id` header, or invalid query parameters.
- `401` — Unauthorized if authorization token is not provided or invalid.
- `403` — Forbidden if user access is not right.

---

[API](https://skmtc.dev/certifyos/apis/certifyos-api.md) · [All operations](https://skmtc.dev/certifyos/apis/certifyos-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/certifyos/certifyos-api/revisions/6ef2fa526e0f/schema)