--- updatedAt: 2026-06-29T14:38:34.000Z --- Fetch the complete documentation index at: https://developers.kommo.com/llms.txt. Use this file to discover all available pages before exploring further. Append .md to any documentation page URL to get its markdown version. # Tasks list **Data type header when the request is successful**\ Content-Type: application/hal+json **Data type header in case of an error**\ Content-Type: application/problem+json ### An example of the request In the following example we will get a list of all completed tasks with the type 2 (Meeting) limiting the sample to 2 rows. ``` https://example.kommo.com/api/v4/tasks?filter[task_type]=2&filter[is_completed]=1&limit=2 ``` ### Response parameters Method returns an array of task objects. The properties of an object are listed below. | Parameter | Data type | Description | | :-------------------- | :-------- | :------------------------------------------------- | | id | int | Task ID | | created\_by | int | ID of the user who created the task | | updated\_by | int | ID of the user who edited the task last | | created\_at | int | Task creation date in the format of Unix Timestamp | | updated\_at | int | Task edit date in the format of Unix Timestamp | | responsible\_user\_id | int | Task responsible user ID | | group\_id | int | Group ID of the task responsible user | | entity\_id | int | ID of the entity the task is linked to | | entity\_type | string | Type of the entity the task is linked to | | is\_completed | bool | Defines whether the task is completed | | task\_type\_id | int | Task type | | text | string | Task description | | duration | int | Task duration in seconds | | complete\_till | int | Task deadline date in the format of Unix Timestamp | | result | object | Task result | | result\[text] | string | Task result text | | account\_id | int | Account ID where the task is located in | # OpenAPI definition ```json { "openapi": "3.1.0", "info": { "title": "kommo-api-references", "version": "1.0" }, "servers": [ { "url": "https://{subdomain}.kommo.com", "variables": { "subdomain": { "default": "subdomain" } } } ], "components": { "securitySchemes": { "sec0": { "type": "oauth2", "flows": {} } } }, "security": [ { "sec0": [] } ], "paths": { "/api/v4/tasks": { "get": { "summary": "Tasks list", "description": "", "operationId": "tasks-list", "parameters": [ { "name": "page", "in": "query", "description": "Page number", "schema": { "type": "integer", "format": "int32" } }, { "name": "limit", "in": "query", "description": "The number of the entities returned in the response of one request (limit – 250)", "schema": { "type": "integer", "format": "int32" } }, { "name": "filter[responsible_user_id][]", "in": "query", "description": "Filter by the task responsible user ID. Either a single ID or an array of IDs can be passed", "schema": { "type": "array", "items": { "type": "integer", "format": "int32" } } }, { "name": "filter[is_completed]", "in": "query", "description": "Filter by the task status. 1 – completed, 0 – open", "schema": { "type": "integer", "format": "int32" } }, { "name": "filter[task_type][]", "in": "query", "description": "Filter by the task type ID. Either a single ID or an array of IDs can be passed", "schema": { "type": "array", "items": { "type": "integer", "format": "int32" } } }, { "name": "filter[entity_type]", "in": "query", "description": "Filter by the entity type the task is linked to", "schema": { "type": "string", "enum": [ "leads", "contacts", "companies" ] } }, { "name": "filter[entity_id][]", "in": "query", "description": "Filter by the entity ID the task is linked to. To use the filter, the value should be passed into filter[entity_type]. Either a single ID or an array of IDs can be passed", "schema": { "type": "array", "items": { "type": "integer", "format": "int32" } } }, { "name": "filter[id][]", "in": "query", "description": "Filter by the task ID. Either a single ID or an array of IDs can be passed", "schema": { "type": "array", "items": { "type": "integer", "format": "int32" } } }, { "name": "filter[updated_at]", "in": "query", "description": "Filter by the last task edit. A timestamp can be passed, in that case, tasks edited after the timestamp value will be returned.", "schema": { "type": "integer", "format": "int32" } }, { "name": "filter[updated_at][from]", "in": "query", "description": "Filter by the last task edit. A timestamp can be passed.", "schema": { "type": "integer", "format": "int32" } }, { "name": "filter[updated_at][to]", "in": "query", "description": "Filter by the last task edit. A timestamp can be passed.", "schema": { "type": "integer", "format": "int32" } }, { "name": "order[complete_till]", "in": "query", "description": "Values available to sort by: asc, desc.", "schema": { "type": "string" } }, { "name": "order[created_at]", "in": "query", "description": "Values available to sort by: asc, desc.", "schema": { "type": "string" } }, { "name": "order[id]", "in": "query", "description": "Values available to sort by: asc, desc.", "schema": { "type": "string" } } ], "responses": { "200": { "description": "200", "content": { "application/json": { "examples": { "Request successful": { "value": "{\n \"_page\": 1,\n \"_links\": {\n \"self\": {\n \"href\": \"https://example.kommo.com/api/v4/tasks?filter[task_type]=2&filter[is_completed]=1&limit=2&page=1\"\n },\n \"next\": {\n \"href\": \"https://example.kommo.com/api/v4/tasks?filter[task_type]=2&filter[is_completed]=1&limit=2&page=2\"\n }\n },\n \"_embedded\": {\n \"tasks\": [\n {\n \"id\": 7087,\n \"created_by\": 3987910,\n \"updated_by\": 3987910,\n \"created_at\": 1575364000,\n \"updated_at\": 1575364851,\n \"responsible_user_id\": 123123,\n \"group_id\": 0,\n \"entity_id\": 167353,\n \"entity_type\": \"leads\",\n \"duration\": 0,\n \"is_completed\": true,\n \"task_type_id\": 2,\n \"text\": \"Send an invitation\",\n \"result\": [],\n \"complete_till\": 1575665940,\n \"account_id\": 321321,\n \"_links\": {\n \"self\": {\n \"href\": \"https://example.kommo.com/api/v4/tasks/7087\"\n }\n }\n },\n {\n \"id\": 215089,\n \"created_by\": 0,\n \"updated_by\": 3987910,\n \"created_at\": 1576767879,\n \"updated_at\": 1576767914,\n \"responsible_user_id\": 123123,\n \"group_id\": 0,\n \"entity_id\": 1035487,\n \"entity_type\": \"leads\",\n \"duration\": 0,\n \"is_completed\": true,\n \"task_type_id\": 2,\n \"text\": \"Schedule a meeting\",\n \"result\": [],\n \"complete_till\": 1576768179,\n \"account_id\": 321312,\n \"_links\": {\n \"self\": {\n \"href\": \"https://example.kommo.com/api/v4/tasks/215089\"\n }\n }\n }\n ]\n }\n}" } }, "schema": { "type": "object", "properties": { "_page": { "type": "integer", "example": 1, "default": 0 }, "_links": { "type": "object", "properties": { "self": { "type": "object", "properties": { "href": { "type": "string", "example": "https://example.kommo.com/api/v4/tasks?filter[task_type]=2&filter[is_completed]=1&limit=2&page=1" } } }, "next": { "type": "object", "properties": { "href": { "type": "string", "example": "https://example.kommo.com/api/v4/tasks?filter[task_type]=2&filter[is_completed]=1&limit=2&page=2" } } } } }, "_embedded": { "type": "object", "properties": { "tasks": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer", "example": 7087, "default": 0 }, "created_by": { "type": "integer", "example": 3987910, "default": 0 }, "updated_by": { "type": "integer", "example": 3987910, "default": 0 }, "created_at": { "type": "integer", "example": 1575364000, "default": 0 }, "updated_at": { "type": "integer", "example": 1575364851, "default": 0 }, "responsible_user_id": { "type": "integer", "example": 123123, "default": 0 }, "group_id": { "type": "integer", "example": 0, "default": 0 }, "entity_id": { "type": "integer", "example": 167353, "default": 0 }, "entity_type": { "type": "string", "example": "leads" }, "duration": { "type": "integer", "example": 0, "default": 0 }, "is_completed": { "type": "boolean", "example": true, "default": true }, "task_type_id": { "type": "integer", "example": 2, "default": 0 }, "text": { "type": "string", "example": "Send an invitation" }, "result": { "type": "array" }, "complete_till": { "type": "integer", "example": 1575665940, "default": 0 }, "account_id": { "type": "integer", "example": 321321, "default": 0 }, "_links": { "type": "object", "properties": { "self": { "type": "object", "properties": { "href": { "type": "string", "example": "https://example.kommo.com/api/v4/tasks/7087" } } } } } } } } } } } } } } }, "401": { "description": "401", "content": { "application/json": { "examples": { "User is not authorized": { "value": "{}" } }, "schema": { "type": "object", "properties": {} } } } } }, "x-readme": { "code-samples": [ { "language": "text", "code": "https://example.kommo.com/api/v4/tasks?filter[task_type]=2&filter[is_completed]=1&limit=2 " } ], "samples-languages": [ "text" ] } } } }, "x-readme": { "headers": [], "explorer-enabled": true, "proxy-enabled": true }, "x-readme-fauxas": true } ```