---
title: "Get worker task flows"
method: GET
path: "/api/servicetodo/processes/workers/{workerIdentifier}/taskFlows"
tags: ["todoWorkers"]
---

# Get worker task flows

`GET /api/servicetodo/processes/workers/{workerIdentifier}/taskFlows`

## Request

- Base URL: `https://services.fountain.com`
- URL: `https://services.fountain.com/api/servicetodo/processes/workers/{workerIdentifier}/taskFlows`
- Auth: HTTP bearer

## Path parameters

- `workerIdentifier` string, uuid, required

## Query parameters

- `includeArchived` boolean

## Response `200`

A collection of taskFlows for a given worker with data related to the completion of the taskFlow / tasks

- object
  - `data` object
    - `stats` object
      - `urgent` number
      - `toReview` number
      - `notStarted` number
      - `inProgress` number
      - `completed` number
      - `total` number
    - `taskFlows` object[]
      - `uuid` string, uuid
      - `lastUpdated` string, date-time
      - `name` string
      - `deadlineDate` string, date-time
      - `status` 'notStarted' | 'inProgress' | 'toReview' | 'completed' | 'rejected' | 'error' | 'overdue'
      - `approvedByAdmin` boolean
      - `workerProgress` 'notStarted' | 'inProgress' | 'workerTasksComplete': Progress over the worker-owned tasks only.
      - `totalFlowStatus` 'notStarted' | 'workerActionRequired' | 'adminActionRequired' | 'blockedOrFailed' | 'complete': End-to-end flow status, internal tasks, reviews and counter-signatures included.
      - `adminActionReasons` string[]: Why the flow waits on an admin.
      - `workerTaskCounts` object: Worker-owned tasks the worker has handed off, out of all worker-owned tasks.
        - `done` number, required
        - `total` number, required
      - `adminTaskCounts` object: Completed admin-side tasks, out of the internal and automation tasks plus the worker tasks with a review or counter-signature step.
        - `done` number, required
        - `total` number, required
      - `adminActionTaskCounts` object: Tasks waiting on an admin, per reason. A reason with none is absent.
        - `review` number
        - `rejectedSubmission` number
        - `countersignature` number
        - `employerTask` number
        - `externalFollowUp` number
      - `tasks` object[]
        - `adminOwned` boolean: An internal or automation task, which the admin owns.
        - `uuid` string, uuid, required
        - `status` 'error' | 'pending' | 'ready' | 'viewed' | 'inProgress' | 'completed'
        - `reviewStatus` 'toReview' | 'approved' | 'rejected'
        - `lastUpdatedAt` string, date
        - `createdAt` string, date
        - `taskUuid` string, uuid
        - `position` number
        - `virtualTask` object
          - `uuid` string, uuid
          - `createdAt` string, date-time
          - `createdBy` string, uuid
          - `lastUpdatedAt` string, date-time
          - `lastUpdatedBy` string, uuid
          - `lastUpdatedByAudience` string
          - `lastUpdatedByAudienceUuid` string, uuid
          - `lastUpdatedByImpersonatedBy` string, uuid
          - `lastUpdatedByCompanyUuid` string, uuid
          - `lastUpdatedByEnterpriseUuid` string, uuid
          - `companyUuid` string, uuid, required
          - `title` string, required
          - `description` string
          - `taskType` 'dataCollection' | 'informationSharing' | 'training' | 'backgroundCheck' | 'tinCheck' | 'i9' | 'w4' | 'documentSigning' | 'universal' | 'partnerTask' | 'video' | 'internalDataReview' | 'internalExternalAction' | 'compliance', required
          - `subType` 'default' | 'iframe' | 'webhook' | 'workato' | 'youtube'
          - `estimatedCompletionMinutes` number
          - `content` object
            - `buttonLabel` string
            - `text` string
            - `attachments` object[]: Optional list of file attachments associated with an information-sharing task. Files are stored in service-media under the ATTACHMENTS storage folder and referenced here by UUID.
              - …
            - `uuid` string
            - `title` string
            - `subtitle` string
            - `description` string
            - `inputs` object[]
              - …
            - `options` object
            - `signDoc` object, nullable
              - …
            - `signDocUuid` string
            - `section2CompletionMethods` object[]
              - …
            - `url` string
            - `bgcProvider` string
            - `bgcPackage` string
            - `tinProvider` string
            - `endEvent` string
            - `hideCompletedButton` boolean
            - `appendWxQueryParams` boolean
            - `displayMode` 'iframe' | 'newTab'
            - `sensitiveData` boolean
            - `useI9C2PayloadFormat` boolean
            - `signingSecret` string: Encrypted HMAC-SHA256 signing secret for webhook deliveries. Obtain via POST /processes/tasks/webhookSigningSecret; the value stored here is the encrypted form and cannot be used to verify signatures. When set, every delivery includes X-Fountain-Signature and X-Fountain-Timestamp headers.
            - `customHeaders` object[]: Custom HTTP headers included in every webhook delivery for this endpoint. Each value must be the encrypted form returned by POST /processes/tasks/webhookCustomHeaderValue — never the clear text; a write carrying any other value is rejected, so a credential is never stored in clear text. Names must follow HTTP naming rules and cannot be a header Fountain already sets (Content-Type, Accept, X-Fountain-*, and transport headers). A delivery with an invalid header set is not sent and is recorded as an error on the assigned task.
              - …
            - `triggerableType` 'flow' | 'task'
            - `triggerableTaskUuid` string
            - `companyAttributeSetUuid` string
            - `companyAttributeSet` object, nullable
              - …
            - `customAttribute` object
              - …
            - `instructionNotes` string
            - `attributesToReview` string[]
            - `requirementUuid` string, uuid: UUID of the compliance requirement from service-compliancev2
          - `requireReview` boolean
          - `reviewerEmployerUuids` string[]: Who reviews this task: employer uuids, or the roles supervisor and opening_owner resolved per worker. Allowed only when requireReview is true. Empty names no specific reviewer.
          - `reuseInRehire` boolean: When true (default), the task completion is carried over to the rehire profile. When false, the task starts incomplete in the rehire profile. Ignored for I-9, W-4, Background Check, and TIN Check tasks (always start incomplete).
          - `rehireReuseMode` 'complete' | 'review': How a reused task is applied on rehire. 'complete' (default when absent) copies the previous answers and marks the task complete. 'review' prefills the previous answers but leaves the task incomplete for the worker to review and submit. Only consulted when reuseInRehire is not false.
          - `signedDocumentEmail` object: Email the signed PDF to the worker and these admins when a document-signing task's request is fully signed. Entries are employer uuids or `supervisor` / `opening_owner`. Document-signing tasks only.
            - `enabled` boolean, required
            - `recipientEmployerUuids` string[]
          - `isInternal` boolean
          - `internalTaskData` object
            - `employerUuids` string[]
            - `trigger` object
              - …
  - `meta` ResponsesPartMeta
    - `timestamp` string, date-time, required
    - `verb` 'OPTION' | 'GET' | 'PUT' | 'POST' | 'PATCH' | 'DELETE'
    - `path` string
    - `jti` string
    - `rid` string
    - `count` number
    - `capped` boolean: The server lowered filter[limit] to its ceiling. Page with filter[skip] to read past it.
    - `status` string
    - `duration` number
    - `size` number

---

[API](https://skmtc.dev/fountain/apis/worker-experience-public-api.md) - [All operations](https://skmtc.dev/fountain/apis/worker-experience-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/fountain/apis/worker-experience-public-api/revisions/6b9a31f79e22?raw)