---
title: "List tasks"
method: GET
path: "/v1/tasks"
tags: ["Task"]
---

# List tasks

`GET /v1/tasks`

Retrieves a paginated list of tasks with optional sorting. The response includes task details and statistics.

## Query parameters

- `sort` 'dateTime' | 'time' | 'created'
- `order` 'asc' | 'desc'
- `page` integer
- `limit` integer
- `organizationId` string

## Response `200`

List of tasks with statistics

- TaskList
  - `items` TaskDto[]
    - `id` string
    - `user` string
    - `deleted` boolean
    - `running` boolean
    - `lastUpdate` integer
    - `created` integer
    - `description` string
    - `location` string
    - `locationEnd` string
    - `startDateTime` string
    - `endDateTime` string
    - `feeling` integer
    - `typeId` integer
    - `paid` boolean
    - `billed` boolean
    - `billable` boolean
    - `phoneNumber` string
    - `distance` string, decimal
    - `signature` string
    - `project` ProjectDto
      - `id` string
      - `user` string
      - `lastUpdate` integer
      - `created` integer
      - `deleted` boolean
      - `title` string
      - `description` string
      - `employer` string
      - `office` string
      - `color` integer
      - `taskDefaultBillable` boolean
      - `archived` boolean
      - `salaryVisibility` integer
      - `salary` string, decimal
      - `team` TeamDto
        - `id` string
        - `organization` OrganizationDto
          - `id` string
          - `name` string
          - `description` string
          - `image` string
          - `color` integer
          - `subscription` CustomerSubscriptionDto
            - `id` string
            - `user` string
            - `expires` integer
            - `status` integer
            - `plan` integer
            - `licenses` integer
            - `paymentOption` string
            - `business` string
            - `email` string
            - `firstname` string
            - `lastname` string
            - `vatId` string
            - `displayName` string
            - `street` string
            - `city` string
            - `state` string
            - `zip` string
            - `country` string
            - `countryIso` string
            - `language` string
            - `includeTaxForBusiness` boolean
            - `activated` boolean
            - `pastDue` boolean
            - `cancellationOffer` boolean
            - `subscriptionActive` boolean
            - `subscriptionCancelled` boolean
            - `subscriptionInactive` boolean
            - `paymentProviderActive` boolean
            - `startedTestimonial` string, date-time
            - `activationDate` string, date-time
            - `cancellationDate` string, date-time
            - `permissionAdmin` boolean
            - `valid` boolean
            - `expired` boolean
            - `validAndActivated` boolean
            - `payPalPayment` boolean
            - `stripePayment` boolean
            - `invoicePayment` boolean
            - `googlePlayPayment` boolean
            - `appleStorePayment` boolean
            - `currency` string
            - `businessCustomer` boolean
            - `euCustomer` boolean
            - `eu` boolean
            - `at` boolean
            - `ch` boolean
            - `uk` boolean
            - `product` string
            - `licenseQuantity` integer
            - `active` boolean
            - `trial` boolean
            - `cancelled` boolean
            - `member` boolean
            - `businessOrTrial` boolean
            - `pro` boolean
            - `planEnterprise` boolean
            - `planBusiness` boolean
            - `planPro` boolean
            - `planPlus` boolean
            - `planBasic` boolean
            - `monthlyPlan` boolean
            - `yearlyPlan` boolean
            - `organization` boolean
          - `user` string
          - `aiChatEnabled` boolean
          - `lastUpdate` integer
          - `created` integer
          - `deleted` boolean
          - `permission` OrganizationPermissionDto
            - `invoicing` boolean
            - `billing` boolean
            - `admin` boolean
        - `organizationId` string
        - `name` string
        - `description` string
        - `image` string
        - `color` integer
        - `projectSalaryVisibility` integer
        - `user` string
        - `lastUpdate` integer
        - `created` integer
        - `deleted` boolean
        - `permission` TeamPermissionDto
          - `role` string
          - `owner` boolean
          - `manager` boolean
          - `member` boolean
          - `managerOrOwner` boolean
        - `projects` integer
        - `members` integer
        - `projectSalaryVisible` boolean
      - `permission` ProjectPermissionDto
        - `role` string
        - `owner` boolean
        - `manager` boolean
        - `member` boolean
        - `managerOrOwner` boolean
      - `duration` integer
      - `durationBreak` integer
      - `salaryTotal` string, decimal
      - `salaryBreak` string, decimal
      - `expenses` string, decimal
      - `expensesPaid` string, decimal
      - `mileage` string, decimal
      - `todoEstimatedDuration` integer
      - `todoTrackedDuration` integer
      - `todoCount` integer
      - `titleAndClient` string
      - `salaryVisible` boolean
    - `todo` ToDoDto
      - `id` string
      - `user` string
      - `deleted` boolean
      - `lastUpdate` integer
      - `created` integer
      - `project` ProjectDto
        - `id` string
        - `user` string
        - `lastUpdate` integer
        - `created` integer
        - `deleted` boolean
        - `title` string
        - `description` string
        - `employer` string
        - `office` string
        - `color` integer
        - `taskDefaultBillable` boolean
        - `archived` boolean
        - `salaryVisibility` integer
        - `salary` string, decimal
        - `team` TeamDto
          - `id` string
          - `organization` OrganizationDto
            - `id` string
            - `name` string
            - `description` string
            - `image` string
            - `color` integer
            - `subscription` CustomerSubscriptionDto
              - …
            - `user` string
            - `aiChatEnabled` boolean
            - `lastUpdate` integer
            - `created` integer
            - `deleted` boolean
            - `permission` OrganizationPermissionDto
              - …
          - `organizationId` string
          - `name` string
          - `description` string
          - `image` string
          - `color` integer
          - `projectSalaryVisibility` integer
          - `user` string
          - `lastUpdate` integer
          - `created` integer
          - `deleted` boolean
          - `permission` TeamPermissionDto
            - `role` string
            - `owner` boolean
            - `manager` boolean
            - `member` boolean
            - `managerOrOwner` boolean
          - `projects` integer
          - `members` integer
          - `projectSalaryVisible` boolean
        - `permission` ProjectPermissionDto
          - `role` string
          - `owner` boolean
          - `manager` boolean
          - `member` boolean
          - `managerOrOwner` boolean
        - `duration` integer
        - `durationBreak` integer
        - `salaryTotal` string, decimal
        - `salaryBreak` string, decimal
        - `expenses` string, decimal
        - `expensesPaid` string, decimal
        - `mileage` string, decimal
        - `todoEstimatedDuration` integer
        - `todoTrackedDuration` integer
        - `todoCount` integer
        - `titleAndClient` string
        - `salaryVisible` boolean
      - `name` string
      - `description` string
      - `status` integer
      - `dueDate` string
      - `assignedUsers` string
      - `assignedMembers` Member[]
        - `uid` string
        - `firstname` string
        - `lastname` string
        - `email` string
        - `employeeId` string
        - `imageUrl` string
        - `deleted` boolean
        - `activity` Activity
          - `projectId` string
          - `projectTitle` string
          - `projectColor` integer
          - `taskId` string
          - `startDateTime` string
          - `endDateTime` string
          - `location` string
          - `running` boolean
        - `displayName` string
        - `initials` string
      - `estimatedHours` integer
      - `estimatedMinutes` integer
      - `duration` integer
      - `durationBreak` integer
      - `salaryTotal` string, decimal
      - `salaryBreak` string, decimal
      - `expenses` string, decimal
      - `expensesPaid` string, decimal
      - `mileage` string, decimal
      - `progress` number, double
    - `rate` RateDto
      - `id` string
      - `user` string
      - `lastUpdate` integer
      - `created` integer
      - `deleted` boolean
      - `title` string
      - `factor` string, decimal
      - `extra` string, decimal
      - `enabled` boolean
      - `archived` boolean
      - `team` TeamDto
        - `id` string
        - `organization` OrganizationDto
          - `id` string
          - `name` string
          - `description` string
          - `image` string
          - `color` integer
          - `subscription` CustomerSubscriptionDto
            - `id` string
            - `user` string
            - `expires` integer
            - `status` integer
            - `plan` integer
            - `licenses` integer
            - `paymentOption` string
            - `business` string
            - `email` string
            - `firstname` string
            - `lastname` string
            - `vatId` string
            - `displayName` string
            - `street` string
            - `city` string
            - `state` string
            - `zip` string
            - `country` string
            - `countryIso` string
            - `language` string
            - `includeTaxForBusiness` boolean
            - `activated` boolean
            - `pastDue` boolean
            - `cancellationOffer` boolean
            - `subscriptionActive` boolean
            - `subscriptionCancelled` boolean
            - `subscriptionInactive` boolean
            - `paymentProviderActive` boolean
            - `startedTestimonial` string, date-time
            - `activationDate` string, date-time
            - `cancellationDate` string, date-time
            - `permissionAdmin` boolean
            - `valid` boolean
            - `expired` boolean
            - `validAndActivated` boolean
            - `payPalPayment` boolean
            - `stripePayment` boolean
            - `invoicePayment` boolean
            - `googlePlayPayment` boolean
            - `appleStorePayment` boolean
            - `currency` string
            - `businessCustomer` boolean
            - `euCustomer` boolean
            - `eu` boolean
            - `at` boolean
            - `ch` boolean
            - `uk` boolean
            - `product` string
            - `licenseQuantity` integer
            - `active` boolean
            - `trial` boolean
            - `cancelled` boolean
            - `member` boolean
            - `businessOrTrial` boolean
            - `pro` boolean
            - `planEnterprise` boolean
            - `planBusiness` boolean
            - `planPro` boolean
            - `planPlus` boolean
            - `planBasic` boolean
            - `monthlyPlan` boolean
            - `yearlyPlan` boolean
            - `organization` boolean
          - `user` string
          - `aiChatEnabled` boolean
          - `lastUpdate` integer
          - `created` integer
          - `deleted` boolean
          - `permission` OrganizationPermissionDto
            - `invoicing` boolean
            - `billing` boolean
            - `admin` boolean
        - `organizationId` string
        - `name` string
        - `description` string
        - `image` string
        - `color` integer
        - `projectSalaryVisibility` integer
        - `user` string
        - `lastUpdate` integer
        - `created` integer
        - `deleted` boolean
        - `permission` TeamPermissionDto
          - `role` string
          - `owner` boolean
          - `manager` boolean
          - `member` boolean
          - `managerOrOwner` boolean
        - `projects` integer
        - `members` integer
        - `projectSalaryVisible` boolean
    - `member` Member
      - `uid` string
      - `firstname` string
      - `lastname` string
      - `email` string
      - `employeeId` string
      - `imageUrl` string
      - `deleted` boolean
      - `activity` Activity
        - `projectId` string
        - `projectTitle` string
        - `projectColor` integer
        - `taskId` string
        - `startDateTime` string
        - `endDateTime` string
        - `location` string
        - `running` boolean
      - `displayName` string
      - `initials` string
    - `invoiceId` string
    - `tags` TagDto[]
      - `id` string
      - `user` string
      - `lastUpdate` integer
      - `created` integer
      - `deleted` boolean
      - `name` string
      - `color` integer
      - `archived` boolean
      - `team` TeamDto
        - `id` string
        - `organization` OrganizationDto
          - `id` string
          - `name` string
          - `description` string
          - `image` string
          - `color` integer
          - `subscription` CustomerSubscriptionDto
            - `id` string
            - `user` string
            - `expires` integer
            - `status` integer
            - `plan` integer
            - `licenses` integer
            - `paymentOption` string
            - `business` string
            - `email` string
            - `firstname` string
            - `lastname` string
            - `vatId` string
            - `displayName` string
            - `street` string
            - `city` string
            - `state` string
            - `zip` string
            - `country` string
            - `countryIso` string
            - `language` string
            - `includeTaxForBusiness` boolean
            - `activated` boolean
            - `pastDue` boolean
            - `cancellationOffer` boolean
            - `subscriptionActive` boolean
            - `subscriptionCancelled` boolean
            - `subscriptionInactive` boolean
            - `paymentProviderActive` boolean
            - `startedTestimonial` string, date-time
            - `activationDate` string, date-time
            - `cancellationDate` string, date-time
            - `permissionAdmin` boolean
            - `valid` boolean
            - `expired` boolean
            - `validAndActivated` boolean
            - `payPalPayment` boolean
            - `stripePayment` boolean
            - `invoicePayment` boolean
            - `googlePlayPayment` boolean
            - `appleStorePayment` boolean
            - `currency` string
            - `businessCustomer` boolean
            - `euCustomer` boolean
            - `eu` boolean
            - `at` boolean
            - `ch` boolean
            - `uk` boolean
            - `product` string
            - `licenseQuantity` integer
            - `active` boolean
            - `trial` boolean
            - `cancelled` boolean
            - `member` boolean
            - `businessOrTrial` boolean
            - `pro` boolean
            - `planEnterprise` boolean
            - `planBusiness` boolean
            - `planPro` boolean
            - `planPlus` boolean
            - `planBasic` boolean
            - `monthlyPlan` boolean
            - `yearlyPlan` boolean
            - `organization` boolean
          - `user` string
          - `aiChatEnabled` boolean
          - `lastUpdate` integer
          - `created` integer
          - `deleted` boolean
          - `permission` OrganizationPermissionDto
            - `invoicing` boolean
            - `billing` boolean
            - `admin` boolean
        - `organizationId` string
        - `name` string
        - `description` string
        - `image` string
        - `color` integer
        - `projectSalaryVisibility` integer
        - `user` string
        - `lastUpdate` integer
        - `created` integer
        - `deleted` boolean
        - `permission` TeamPermissionDto
          - `role` string
          - `owner` boolean
          - `manager` boolean
          - `member` boolean
          - `managerOrOwner` boolean
        - `projects` integer
        - `members` integer
        - `projectSalaryVisible` boolean
      - `totalTime` integer
    - `pauses` PauseDto[]
      - `id` string
      - `user` string
      - `deleted` boolean
      - `running` boolean
      - `lastUpdate` integer
      - `created` integer
      - `description` string
      - `startDateTime` string
      - `endDateTime` string
      - `task` TaskDto — recursive
      - `member` Member
        - `uid` string
        - `firstname` string
        - `lastname` string
        - `email` string
        - `employeeId` string
        - `imageUrl` string
        - `deleted` boolean
        - `activity` Activity
          - `projectId` string
          - `projectTitle` string
          - `projectColor` integer
          - `taskId` string
          - `startDateTime` string
          - `endDateTime` string
          - `location` string
          - `running` boolean
        - `displayName` string
        - `initials` string
    - `expenses` ExpenseDto[]
      - `id` string
      - `user` string
      - `deleted` boolean
      - `lastUpdate` integer
      - `created` integer
      - `description` string
      - `dateTime` string
      - `amount` string, decimal
      - `refunded` boolean
      - `fileUri` string
      - `fileName` string
      - `task` TaskDto — recursive
      - `member` Member
        - `uid` string
        - `firstname` string
        - `lastname` string
        - `email` string
        - `employeeId` string
        - `imageUrl` string
        - `deleted` boolean
        - `activity` Activity
          - `projectId` string
          - `projectTitle` string
          - `projectColor` integer
          - `taskId` string
          - `startDateTime` string
          - `endDateTime` string
          - `location` string
          - `running` boolean
        - `displayName` string
        - `initials` string
      - `invoiceId` string
    - `notes` NoteDto[]
      - `id` string
      - `user` string
      - `deleted` boolean
      - `lastUpdate` integer
      - `created` integer
      - `text` string
      - `dateTime` string
      - `uri` string
      - `driveId` string
      - `task` TaskDto — recursive
      - `member` Member
        - `uid` string
        - `firstname` string
        - `lastname` string
        - `email` string
        - `employeeId` string
        - `imageUrl` string
        - `deleted` boolean
        - `activity` Activity
          - `projectId` string
          - `projectTitle` string
          - `projectColor` integer
          - `taskId` string
          - `startDateTime` string
          - `endDateTime` string
          - `location` string
          - `running` boolean
        - `displayName` string
        - `initials` string
    - `duration` integer
    - `durationBreak` integer
    - `salaryTotal` string, decimal
    - `salaryBreak` string, decimal
    - `expensesTotal` string, decimal
    - `expensesPaid` string, decimal
    - `expensesCount` integer
    - `expensesPaidCount` integer
    - `mileage` string, decimal
    - `notesTotal` integer
    - `salaryVisible` boolean
  - `params` TaskListParams
    - `search` string
    - `sort` string
    - `order` string
    - `count` integer
    - `page` integer
    - `limit` integer
    - `startDate` string
    - `endDate` string
    - `organizationId` string
    - `teamId` string
    - `projectId` string
    - `todoId` string
    - `rateId` string
    - `documentId` string
    - `type` string
    - `filter` string
    - `teamIds` string[]
    - `projectIds` string[]
    - `tagIds` string[]
    - `taskIds` string[]
    - `userIds` string[]
    - `feelings` integer[]
    - `excludeTaskIds` string[]
    - `populatePauses` boolean
    - `populateExpenses` boolean
    - `populateNotes` boolean
    - `populateTags` boolean
    - `offset` integer
  - `taskStatistic` TaskStatistic
    - `duration` integer
    - `durationBreak` integer
    - `salaryTotal` string, decimal
    - `salaryBreak` string, decimal
    - `expensesTotal` string, decimal
    - `expensesPaid` string, decimal
    - `mileage` string, decimal

## Other responses

- `400` — Bad request - invalid parameters
- `401` — Not authorized - invalid or missing authentication

---

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