---
title: "List Project Tasks"
method: GET
path: "/projects/{projectId}/tasks"
tags: ["Tasks"]
---

# List Project Tasks

`GET /projects/{projectId}/tasks`

## Request

- Base URL: `https://api.crowdin.com/api/v2`
- URL: `https://api.crowdin.com/api/v2/projects/{projectId}/tasks`
- Auth: none declared
- TypeScript: <https://skmtc.dev/crowdin/apis/crowdin-enterprise-api-v2/docs/projects/:projectId/tasks/get.ts> (a function with typed inputs; its response is checked against the schema)

**Required scopes:** `project.task` (Read only).

## Path parameters

- `projectId` integer, required

## Query parameters

- `orderBy` 'id' | 'type' | 'title' | 'status' | 'description' | 'createdAt' | 'updatedAt' | 'deadline' | 'startedAt' | 'resolvedAt'
- `limit` integer
- `offset` integer
- `status` 'review' | 'todo' | 'in_progress' | 'done' | 'closed'
- `batchId` integer

## Response `200`

Tasks list

- EnterpriseFileBasedTaskCollectionResource: Base schema of resource container. Container is a wrapper object that contains payload in required `data` property and provides space for adding any other metadata.
  - `data` EnterpriseFileBasedTaskResource[], required
    - `data` EnterpriseTask, required
      - `id` integer
      - `projectId` integer
      - `creatorId` integer
      - `type` integer
      - `status` 'todo' | 'in_progress' | 'done' | 'closed'
      - `title` string
      - `batchId` integer
      - `assignees` TaskAssignee[]
        - `id` integer
        - `username` string
        - `fullName` string
        - `avatarUrl` string
        - `wordsCount` integer
        - `wordsLeft` integer
        - `timeSpent` integer
      - `assignedTeams` TaskAssignedTeam[]
        - `id` integer
        - `wordsCount` integer
        - `timeSpent` integer
      - `progress` TaskProgress
        - `total` integer
        - `done` integer
        - `percent` integer
      - `translateProgress` TaskTranslateProgress
        - `total` integer
        - `done` integer
        - `percent` integer
      - `sourceLanguageId` string
      - `targetLanguageId` string
      - `description` string
      - `translationUrl` string
      - `webUrl` string
      - `wordsCount` integer: Number of words currently in the task
      - `originalWordsCount` integer: Number of words when the task was created. Preserved when source strings are later removed.
      - `commentsCount` integer
      - `deadline` string, date-time: in UTC
      - `startedAt` string, date-time: in UTC
      - `resolvedAt` string, date-time: in UTC
      - `timeRange` string
      - `translationsUpdatedTimeRange` string
      - `workflowStepId` integer
      - `buyUrl` string
      - `createdAt` string, date-time: in UTC
      - `updatedAt` string, date-time: in UTC
      - `sourceLanguage` Language: Class LanguageResponseModel
        - `id` string
        - `name` string
        - `editorCode` string: - alias of internal code
        - `twoLettersCode` string: alias of iso6391 code
        - `threeLettersCode` string: alias of iso6393 code
        - `locale` string
        - `androidCode` string
        - `bcp47Code` string
        - `osxCode` string
        - `osxLocale` string
        - `pluralCategoryNames` string[]: plural category names
        - `pluralRules` string: string with plural rules
        - `pluralExamples` string[]: plural examples array
        - `textDirection` 'ltr' | 'rtl'
        - `dialectOf` string, nullable
      - `targetLanguages` Language[]
        - `id` string
        - `name` string
        - `editorCode` string: - alias of internal code
        - `twoLettersCode` string: alias of iso6391 code
        - `threeLettersCode` string: alias of iso6393 code
        - `locale` string
        - `androidCode` string
        - `bcp47Code` string
        - `osxCode` string
        - `osxLocale` string
        - `pluralCategoryNames` string[]: plural category names
        - `pluralRules` string: string with plural rules
        - `pluralExamples` string[]: plural examples array
        - `textDirection` 'ltr' | 'rtl'
        - `dialectOf` string, nullable
      - `labelIds` integer[]
      - `labelMatchRule` 'all' | 'any', nullable
      - `excludeLabelIds` integer[]
      - `excludeLabelMatchRule` 'all' | 'any', nullable
      - `precedingTaskId` integer
      - `estimatedCost` EstimatedTaskCost
        - `cost` number, float
        - `date` string, date-time: in UTC
        - `currency` 'USD' | 'EUR' | 'JPY' | 'GBP' | 'AUD' | 'CAD' | 'CHF' | 'CNY' | 'SEK' | 'NZD' | 'MXN' | 'SGD' | 'HKD' | 'NOK' | 'KRW' | 'TRY' | 'RUB' | 'INR' | 'BRL' | 'ZAR' | 'GEL' | 'UAH' | 'DDK' | 'PLN'
      - `actualCost` ActualTaskCost
        - `cost` number, float
        - `date` string, date-time: in UTC
        - `currency` 'USD' | 'EUR' | 'JPY' | 'GBP' | 'AUD' | 'CAD' | 'CHF' | 'CNY' | 'SEK' | 'NZD' | 'MXN' | 'SGD' | 'HKD' | 'NOK' | 'KRW' | 'TRY' | 'RUB' | 'INR' | 'BRL' | 'ZAR' | 'GEL' | 'UAH' | 'DDK' | 'PLN'
      - `generateCostEstimate` boolean, nullable
      - `generateTranslationCost` boolean, nullable
      - `reportSettingsTemplateId` integer, nullable
      - `filesCount` integer
      - `fileIds` integer[]
      - `fields` EnterpriseAdditionalFields: Fields. Keys get via [List Fields](#operation/api.fields.getMany)
      - `syncScope` object, nullable: How a shared task's words split while it syncs to the vendor. `null` when the task is fully synced, is not shared, or its counterpart task is unavailable. __Note:__ Re-read on every fetch — a synced task can start syncing again
        - `syncedWords` integer: Words already synced into the vendor task.
        - `pendingWords` integer: Words routed to the vendor and awaiting sync.
        - `skippedWords` integer: Words the client's workflow does not share with the vendor; they will never sync.
  - `pagination` Pagination: Pagination Response Model
    - `offset` integer
    - `limit` integer

## Other responses

- `400`: Invalid Request Parameters
- `404`: Project with specified id was not found
- `405`: Method Not Allowed
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crowdin/apis/crowdin-enterprise-api-v2.md) - [All operations](https://skmtc.dev/crowdin/apis/crowdin-enterprise-api-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/crowdin/apis/crowdin-enterprise-api-v2/revisions/dc68744c5384?raw)