---
updatedAt: 2026-06-15T14:45:23.000Z
agentTools:
projectIndex: https://developers.lokalise.com/llms.txt
---
# List all tasks
Lists all tasks in the project.
Requires read_tasks OAuth access scope.
# OpenAPI definition
```json
{
"openapi": "3.0.3",
"info": {
"title": "Default projects",
"version": "1.0.0",
"description": "Describes the API for default projects.\\n\\n**Project Type Compatibility**: Many API endpoints have different compatibility with project types:\\n- **Software projects** (localization_files) - Support individual key management, no file deletion\\n- **Documents projects** (paged_documents) - Support file management, no individual key operations\\n- **Marketing projects** (content_integration, marketing, marketing_integrations) - Mixed support depending on specific type\\n\\nBranching is only supported for Software projects. See individual endpoint documentation for specific compatibility information."
},
"servers": [
{
"url": "https://api.lokalise.com/api2"
}
],
"paths": {
"/projects/{project_id}/tasks": {
"get": {
"responses": {
"200": {
"description": "OK",
"headers": {
"X-Total-Count": {
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"example": {
"project_id": "20008339586cded200e0d8.29879849",
"tasks": [
{
"task_id": 55392,
"title": "Voicemail messages",
"can_be_parent": false,
"task_type": "translation",
"parent_task_id": 12345,
"closing_tags": [
"tag_one",
"tag_two"
],
"do_lock_translations": false,
"description": "Need your help with some voicemail message translation. Thanks!",
"status": "in_progress",
"progress": 25,
"due_date": "2024-12-31 12:00:00 (Etc/UTC)",
"due_date_timestamp": 1546257600,
"keys_count": 3,
"words_count": 91,
"created_at": "2021-12-31 12:00:00 (Etc/UTC)",
"created_at_timestamp": 1640944800,
"created_by": 420,
"created_by_email": "manager@yourcompany.com",
"languages": [
{
"language_iso": "fi",
"language_id": 610,
"language_name": "Finnish",
"users": [
{
"user_id": 421,
"email": "jdoe@mycompany.com",
"fullname": "John Doe"
}
],
"groups": [
{
"id": 191,
"name": "Voicemail translators"
}
],
"keys": [
11212,
11241,
11245
],
"status": "created",
"progress": 0,
"initial_tm_leverage": {
"0%+": 91,
"60%+": 0,
"75%+": 0,
"95%+": 0,
"100%": 0
},
"tm_leverage": {
"status": "completed",
"value": {
"0%+": 30,
"50%+": 0,
"75%+": 0,
"85%+": 0,
"95%+": 0,
"100%": 0
}
},
"keys_count": 3,
"words_count": 91,
"done_words_count": 0,
"completed_at": null,
"completed_at_timestamp": null,
"completed_by": null,
"completed_by_email": null
},
{
"language_iso": "ru",
"language_id": 643,
"language_name": "Russian",
"users": [
{
"user_id": 422,
"email": "jfox@mycompany.com",
"fullname": "James Fox"
}
],
"groups": {},
"keys": [
11212,
11241,
11245
],
"status": "in progress",
"progress": 80,
"initial_tm_leverage": {
"0%+": 91,
"60%+": 0,
"75%+": 0,
"95%+": 0,
"100%": 0
},
"tm_leverage": {
"status": "completed",
"value": {
"0%+": 30,
"50%+": 0,
"75%+": 0,
"85%+": 0,
"95%+": 0,
"100%": 0
}
},
"keys_count": 3,
"words_count": 91,
"done_words_count": 73,
"completed_at": null,
"completed_at_timestamp": null,
"completed_by": null,
"completed_by_email": null
}
],
"source_language_iso": "en",
"auto_close_languages": true,
"auto_close_task": true,
"auto_close_items": true,
"completed_at": null,
"completed_at_timestamp": null,
"completed_by": null,
"completed_by_email": null,
"custom_translation_status_ids": [
77,
85,
86
]
}
]
},
"schema": {
"type": "object",
"properties": {
"project_id": {
"type": "string"
},
"tasks": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Tasks"
}
}
}
}
}
}
}
},
"summary": "List all tasks",
"operationId": "List all tasks",
"description": "Lists all tasks in the project.\n\nRequires read_tasks OAuth access scope.",
"tags": [
"Tasks"
],
"parameters": [
{
"name": "project_id",
"in": "path",
"description": "A unique project identifier",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "filter_title",
"in": "query",
"description": "Set title filter for the list.",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "filter_statuses",
"in": "query",
"description": "One or more task statuses to filter by (comma separated). Possible values are created, queued, in\\_progress and completed.\n",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "limit",
"in": "query",
"description": "Number of items to include (max 5000).",
"required": false,
"example": "100",
"schema": {
"type": "integer"
}
},
{
"name": "page",
"in": "query",
"description": "Return results starting from this page.",
"required": false,
"example": "1",
"schema": {
"type": "integer"
}
}
]
}
}
},
"components": {
"schemas": {
"Tasks": {
"type": "object",
"properties": {
"task_id": {
"type": "number",
"description": "A unique task identifier."
},
"title": {
"type": "string",
"description": "Task title."
},
"description": {
"type": "string",
"description": "Short description of the task."
},
"status": {
"type": "string",
"description": "Status of the task. Allowed values are completed, in_progress, created, queued."
},
"progress": {
"type": "number",
"description": "Task progress in percents (0% - 100%)."
},
"due_date": {
"type": "string",
"description": "Due date."
},
"due_date_timestamp": {
"type": "number",
"description": "Unix timestamp of the Due date."
},
"keys_count": {
"type": "number",
"description": "Total number of keys in the task."
},
"words_count": {
"type": "number",
"description": "Total number of source words in the task."
},
"created_at": {
"type": "string",
"description": "Date and time of the task creation."
},
"created_at_timestamp": {
"type": "number",
"description": "Unix timestamp when the task was created."
},
"created_by": {
"type": "number",
"description": "Identifier of a user, who has created the task."
},
"created_by_email": {
"type": "string",
"description": "E-mail of a user, who has created the task."
},
"can_be_parent": {
"type": "boolean",
"description": "Can task be assigned as a parent task."
},
"task_type": {
"type": "string",
"default": "translation",
"enum": [
"translation",
"automatic_translation",
"lqa_by_ai",
"review"
],
"description": "translation, automatic_translation, lqa_by_ai or review."
},
"parent_task_id": {
"type": "number",
"description": "ID of the parent task."
},
"closing_tags": {
"type": "array",
"items": {},
"description": "Tags that will be added to affected keys when task is closed."
},
"do_lock_translations": {
"type": "boolean",
"description": "If set to true, will lock translations for non-assigned project members."
},
"languages": {
"type": "array",
"items": {
"type": "object",
"properties": {
"language_iso": {
"type": "string",
"description": "Language code."
},
"language_id": {
"type": "number",
"description": "A unique language identifier in the system."
},
"language_name": {
"type": "string",
"description": "Language name."
},
"users": {
"type": "array",
"items": {},
"description": "List of users, assigned to work on the language."
},
"groups": {
"type": "object",
"properties": {
"group": {
"type": "object",
"properties": {
"id": {
"type": "number",
"description": "A unique identifier of the user group."
},
"name": {
"type": "string",
"description": "Name of the group."
}
}
}
},
"description": "List of groups, assigned to work on the language."
},
"keys": {
"type": "array",
"items": {},
"description": "List of keys identifiers, included in task for this language."
},
"status": {
"type": "string",
"description": "Status of the language in the task. Allowed values are completed, in progress, created."
},
"progress": {
"type": "number",
"description": "Language progress in percents (0% - 100%)."
},
"initial_tm_leverage": {
"type": "object",
"deprecated": true,
"description": "Deprecated. We return data for compatibility, but please, rely on \"tm_leverage\" instead.",
"properties": {
"0%+": {
"type": "number",
"description": "Number of words with TM match from 0% to 60%."
},
"60%+": {
"type": "number",
"description": "Number of words with TM match from 60% to 75%."
},
"75%+": {
"type": "number",
"description": "Number of words with TM match from 75% to 95%."
},
"95%+": {
"type": "number",
"description": "Number of words with TM match from 95% to 100%."
},
"100%": {
"type": "number",
"description": "Number of words with TM 100% match."
}
}
},
"tm_leverage": {
"type": "object",
"description": "Translation Memory leverage calculated for a task. It indicates how many words translators can fetch from the memory instead of translating everything from scratch. For large tasks it may take time to calculate TM leverage after the task creation. If the \"status\" is \"pending\", you will see null value and need to retrieve the data again (with a small delay).",
"example": {
"status": "completed",
"value": {
"0%+": 30,
"50%+": 0,
"75%+": 0,
"85%+": 0,
"95%+": 0,
"100%": 0
}
},
"properties": {
"status": {
"type": "string",
"enum": [
"pending",
"completed"
],
"description": "Status of the translation memory leverage."
},
"value": {
"type": "object",
"nullable": true,
"properties": {
"0%+": {
"type": "number",
"description": "Number of words with TM match from 0% to 50%."
},
"50%+": {
"type": "number",
"description": "Number of words with TM match from 50% to 75%."
},
"75%+": {
"type": "number",
"description": "Number of words with TM match from 75% to 85%."
},
"85%+": {
"type": "number",
"description": "Number of words with TM match from 85% to 95%."
},
"95%+": {
"type": "number",
"description": "Number of words with TM match from 95% to 100%."
},
"100%": {
"type": "number",
"description": "Number of words with TM 100% match."
}
}
}
}
},
"keys_count": {
"type": "number",
"description": "Number of keys for the language."
},
"words_count": {
"type": "number",
"description": "Number of source words for the language."
},
"done_words_count": {
"type": "number",
"description": "Number of translated words for the language."
},
"completed_at": {
"type": "string",
"description": "Date and time of the language completion."
},
"completed_at_timestamp": {
"type": "number",
"description": "Unix timestamp when the language was completed."
},
"completed_by": {
"type": "number",
"description": "Identifier of a user, who has completed the language."
},
"completed_by_email": {
"type": "string",
"description": "E-mail of a user, who has completed the language."
}
}
},
"description": "List of languages in the task."
},
"source_language_iso": {
"type": "string",
"description": "Source language code of the task."
},
"auto_close_languages": {
"type": "boolean",
"description": "Whether languages should be closed automatically upon completion of the last item."
},
"auto_close_task": {
"type": "boolean",
"description": "Whether the task should be automatically closed upon all language completion."
},
"auto_close_items": {
"type": "boolean",
"description": "Whether the translation task items should be automatically marked as completed on edit."
},
"completed_at": {
"type": "string",
"description": "Date and time of the task completion."
},
"completed_at_timestamp": {
"type": "number",
"description": "Unix timestamp when the task was completed."
},
"completed_by": {
"type": "number",
"description": "Identifier of a user, who has completed the task."
},
"completed_by_email": {
"type": "string",
"description": "E-mail of a user, who has completed the task."
},
"custom_translation_status_ids": {
"type": "array",
"items": {},
"description": "IDs of custom translation statuses that will be applied to task items after item is completed."
}
}
}
},
"securitySchemes": {
"ApiKeyAuth": {
"type": "apiKey",
"in": "header",
"name": "X-Api-Token"
}
}
},
"security": [
{
"ApiKeyAuth": []
}
]
}
```