--- updatedAt: 2025-06-08T14:09:48.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. # Pipeline stages list This method allows to get a list of pipeline stages on the account. **Limitations**\ The method is available for all account users. **Authorization type**\ OAuth 2.0 with Access Token/ Long-lived token **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 **Response parameters**\ The method returns a stages objects array. The properties of the stage object are listed below. | Parameter | Data type | Description | | :----------- | :-------- | :---------------------------------------------------------------- | | int | int | Stage ID | | name | string | Stage name | | sort | int | Sequence number of the stage in the pipeline | | is\_editable | bool | Defines whether the stage can be edited | | pipeline\_id | int | The ID of the pipeline the stage is located in | | color | string | Stage [color](https://kommo.readme.io/reference/available-colors) | | type | int | Stage type (1 – incoming leads, 0 – regular stage) | | account\_id | int | Account ID the stage 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/leads/pipelines/{pipeline_id}/statuses": { "get": { "summary": "Pipeline stages list", "description": "This method allows to get a list of pipeline stages on the account.", "operationId": "stages-list", "parameters": [ { "name": "pipeline_id", "in": "path", "description": "Pipeline ID", "schema": { "type": "integer", "format": "int32" }, "required": true }, { "name": "with", "in": "query", "description": "Stage description", "schema": { "type": "string", "enum": [ "descriptions" ] } } ], "responses": { "200": { "description": "200", "content": { "application/json": { "examples": { "Request successful": { "value": "{\n \"_total_items\": 7,\n \"_embedded\": {\n \"statuses\": [\n {\n \"id\": 58141803,\n \"name\": \"Incoming leads\",\n \"sort\": 10,\n \"is_editable\": false,\n \"pipeline_id\": 6950551,\n \"color\": \"#c1c1c1\",\n \"type\": 1,\n \"account_id\": 31361463,\n \"_links\": {\n \"self\": {\n \"href\": \"https://devteam.kommo.com/api/v4/leads/pipelines/6950551/statuses/58141803\"\n }\n }\n },\n {\n \"id\": 58141807,\n \"name\": \"Initial contact\",\n \"sort\": 20,\n \"is_editable\": true,\n \"pipeline_id\": 6950551,\n \"color\": \"#99ccff\",\n \"type\": 0,\n \"account_id\": 31361463,\n \"_links\": {\n \"self\": {\n \"href\": \"https://devteam.kommo.com/api/v4/leads/pipelines/6950551/statuses/58141807\"\n }\n }\n },\n {\n \"id\": 58141811,\n \"name\": \"Discussions\",\n \"sort\": 30,\n \"is_editable\": true,\n \"pipeline_id\": 6950551,\n \"color\": \"#ffff99\",\n \"type\": 0,\n \"account_id\": 31361463,\n \"_links\": {\n \"self\": {\n \"href\": \"https://devteam.kommo.com/api/v4/leads/pipelines/6950551/statuses/58141811\"\n }\n }\n },\n {\n \"id\": 58141815,\n \"name\": \"Decision making\",\n \"sort\": 40,\n \"is_editable\": true,\n \"pipeline_id\": 6950551,\n \"color\": \"#ffcc66\",\n \"type\": 0,\n \"account_id\": 31361463,\n \"_links\": {\n \"self\": {\n \"href\": \"https://devteam.kommo.com/api/v4/leads/pipelines/6950551/statuses/58141815\"\n }\n }\n },\n {\n \"id\": 58141819,\n \"name\": \"Contract discussion\",\n \"sort\": 50,\n \"is_editable\": true,\n \"pipeline_id\": 6950551,\n \"color\": \"#ffcccc\",\n \"type\": 0,\n \"account_id\": 31361463,\n \"_links\": {\n \"self\": {\n \"href\": \"https://devteam.kommo.com/api/v4/leads/pipelines/6950551/statuses/58141819\"\n }\n }\n },\n {\n \"id\": 142,\n \"name\": \"Closed - won\",\n \"sort\": 10000,\n \"is_editable\": false,\n \"pipeline_id\": 6950551,\n \"color\": \"#CCFF66\",\n \"type\": 0,\n \"account_id\": 31361463,\n \"_links\": {\n \"self\": {\n \"href\": \"https://devteam.kommo.com/api/v4/leads/pipelines/6950551/statuses/142\"\n }\n }\n },\n {\n \"id\": 143,\n \"name\": \"Closed - lost\",\n \"sort\": 11000,\n \"is_editable\": false,\n \"pipeline_id\": 6950551,\n \"color\": \"#D5D8DB\",\n \"type\": 0,\n \"account_id\": 31361463,\n \"_links\": {\n \"self\": {\n \"href\": \"https://devteam.kommo.com/api/v4/leads/pipelines/6950551/statuses/143\"\n }\n }\n }\n ]\n }\n}" } }, "schema": { "type": "object", "properties": { "_total_items": { "type": "integer", "example": 7, "default": 0 }, "_embedded": { "type": "object", "properties": { "statuses": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer", "example": 58141803, "default": 0 }, "name": { "type": "string", "example": "Incoming leads" }, "sort": { "type": "integer", "example": 10, "default": 0 }, "is_editable": { "type": "boolean", "example": false, "default": true }, "pipeline_id": { "type": "integer", "example": 6950551, "default": 0 }, "color": { "type": "string", "example": "#c1c1c1" }, "type": { "type": "integer", "example": 1, "default": 0 }, "account_id": { "type": "integer", "example": 31361463, "default": 0 }, "_links": { "type": "object", "properties": { "self": { "type": "object", "properties": { "href": { "type": "string", "example": "https://devteam.kommo.com/api/v4/leads/pipelines/6950551/statuses/58141803" } } } } } } } } } } } } } } }, "401": { "description": "401", "content": { "application/json": { "examples": { "The user is not authorized": { "value": "{\n \"title\": \"Unauthorized\",\n \"type\": \"https://httpstatus.es/401\",\n \"status\": 401,\n \"detail\": \"Invalid user name or password\"\n}" } }, "schema": { "type": "object", "properties": { "title": { "type": "string", "example": "Unauthorized" }, "type": { "type": "string", "example": "https://httpstatus.es/401" }, "status": { "type": "integer", "example": 401, "default": 0 }, "detail": { "type": "string", "example": "Invalid user name or password" } } } } } }, "403": { "description": "403", "content": { "text/plain": { "examples": { "Result": { "value": "" } } } } }, "429": { "description": "429", "content": { "text/plain": { "examples": { "Result": { "value": "" } } } } }, "500": { "description": "500", "content": { "text/plain": { "examples": { "Result": { "value": "" } } } } } }, "deprecated": false } } }, "x-readme": { "headers": [], "explorer-enabled": true, "proxy-enabled": true }, "x-readme-fauxas": true } ```