---
title: "Returns a paginated list of tasks for a user, optionally filtered by task status."
method: GET
path: "/api/v1/Tasks"
tags: ["Tasks"]
---

# Returns a paginated list of tasks for a user, optionally filtered by task status.

`GET /api/v1/Tasks`

## Query parameters

- `userId` string, uuid, required
- `status` string
- `cursor` string

## Headers

- `X-API-SECRET` string, required — API Secret is used to verify the integrity of the request and authenticate the client. It should be included in all requests. This value must be kept confidential and should never be exposed in client-side code or public repositories.

## Response `200`

OK

- TaskSimplifiedListViewModelV1 — Paginated response for a list of entities and pagination-related links.
  - `data` TaskSimplifiedViewModelV1[], required — The list of entities in the current page of the result.
    - `id` string, uuid, required — Unique identifier of the task.
    - `type` 'StandAloneBrowserExtensionInstallationTask' | 'StandAloneReviewOffboardingTask' | 'StandAloneReviewOnboardingTask' | 'RequestReviewTask' | 'RequestActionTask', required
    - `createdAt` string, date-time, required — Timestamp when the task was created.
    - `status` 'Approved' | 'Declined' | 'InProgress' | 'Pending' | 'Blocked' | 'Drafted' | 'NoClaimers' | 'Cancelled', required
    - `lastUpdatedAt` string, date-time, required — Timestamp of the most recent update to the task.
    - `isAutoprovisioning` boolean — Indicates whether the task was created as part of the Agent Cake autoprovisioning process.
    - `isActionStep` boolean, nullable — Indicates whether the task is considered an action (provisioning, de-provisioning, etc.) step of a request.
    - `assignedUserId` string, uuid, nullable — Unique identifier of the user currently assigned to the task, if any.
    - `claimerUserIds` string[], nullable — Unique identifiers of users who can claim the task.
    - `requestId` string, uuid, nullable — Unique identifier of the policy-based request related to the task, if any.
    - `offboardingMetadata` ReviewOffboardingMetadataSimplifiedViewModelV1 — Offboarding-related metadata for list responses: opaque user and work app identifiers and optional termination date.
      - `targetUserId` string, uuid, required — Unique identifier of the user being offboarded.
      - `externalIntegrationWorkAppId` string, uuid, required — Unique identifier of the external integration work app involved in offboarding.
      - `terminationDate` string, date-time, nullable — Termination date of the user, if available.
    - `onboardingMetadata` ReviewOnboardingMetadataSimplifiedViewModelV1 — Onboarding-related metadata for list responses: opaque user and work app identifiers and optional start date.
      - `onboardingUserId` string, uuid, nullable — Unique identifier of the user being onboarded, if resolved.
      - `komboWorkAppId` string, uuid, required — Unique identifier of the Kombo work app for the external integration.
      - `externalConnectionAppIsEmailProvider` boolean — Indicates if the external app is also the email provider.
      - `startingDate` string, date-time, nullable — Start date for the onboarding process, if available.
  - `links` LinksViewModel, required — Pagination-related URLs for navigating a paginated collection.
    - `self` string, required — URL to the current resource or page.
    - `next` string, nullable — URL to the next page in the collection, if available.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `500` — Internal Server Error

---

[API](https://skmtc.net/cakewalk/apis/cakewalk-open-api.md) · [All operations](https://skmtc.net/cakewalk/apis/cakewalk-open-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cakewalk/cakewalk-open-api/revisions/5728f183a29d/schema)