---
updatedAt: 2026-09-11T10:24:26.000Z
agentTools:
  projectIndex: https://es-developers.kommo.com/llms.txt
---

# Lista de campos personalizados de una lista

Este método permite obtener una lista de los campos personalizados de una lista.

**Limitaciones**<br />El método está disponible para todos los usuarios de la cuenta.

**Encabezado de tipo de datos cuando la solicitud es exitosa**<br />Content-Type: application/hal+json

**Encabezado de tipo de datos en caso de un error**<br />Content-Type: application/problem+json

## Parámetros de respuesta

El método retorna un arreglo de objetos de campos personalizados. Las propiedades del objeto campo personalizado se enumeran a continuación. Las propiedades del objeto varían según la entidad.

| Parámetro                                | Tipo de dato | Descripción                                                                                                                                                                                                                                                                                                             |
| :--------------------------------------- | :----------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| id                                       | int          | ID del campo                                                                                                                                                                                                                                                                                                            |
| name                                     | string       | Nombre del campo                                                                                                                                                                                                                                                                                                        |
| code                                     | string       | Código del campo que se puede utilizar para actualizar el valor del campo sin pasar el ID del campo en la solicitud.                                                                                                                                                                                                    |
| sort                                     | int          | Ordenación de los campos                                                                                                                                                                                                                                                                                                |
| type                                     | int          | [Tipo de campo](https://es-developers.kommo.com/reference/campos-personalizados)                                                                                                                                                                                                                                        |
| entity\_type                             | string       | Tipo de entidad (`leads`, `contactos`, `companies`)                                                                                                                                                                                                                                                                     |
| is\_predefined                           | bool         | Indica si el campo es predefinido. Este parámetro solo se retorna al obtener la lista de campos de contactos o compañías.                                                                                                                                                                                               |
| is\_deletable                            | bool         | Indica si el campo se puede eliminar. Este parámetro solo se retorna al obtener la lista de campos de contactos o compañías.                                                                                                                                                                                            |
| currency                                 | string\|null |                                                                                                                                                                                                                                                                                                                         |
| remind                                   | string\|null | Configuración de recordatorios de cumpleaños `never`, `day` – día antes del evento, `week` – semana antes del evento, `month` – mes antes del evento). Este valor solo está disponible para el campo de tipo cumpleaños. Este parámetro solo se retorna al obtener una lista de campos de leads, contactos o compañías. |
| enums                                    | array\|null  | Array de valores disponibles para el campo. Solo disponible para los campos con valores enumerados                                                                                                                                                                                                                      |
| enums\[0]                                | object       | Modelo del valor disponible para el campo                                                                                                                                                                                                                                                                               |
| enums\[id]                               | int          | ID del valor                                                                                                                                                                                                                                                                                                            |
| enums\[value]                            | string       | Valor                                                                                                                                                                                                                                                                                                                   |
| enums\[sort]                             | int          | Orden de los valores                                                                                                                                                                                                                                                                                                    |
| enums\[code]                             | string       | Código simbólico de la enumeración                                                                                                                                                                                                                                                                                      |
| is\_api\_only                            | bool         | Indica si el campo es editable solo a través de la API. Este parámetro solo se retorna al obtener una lista de campos de leads, contactos o compañías.                                                                                                                                                                  |
| group\_id                                | string\|null | ID del grupo de campos para el campo actual. Este parámetro solo se retorna al obtener una lista de campos de leads, contactos o compañías.                                                                                                                                                                             |
| required\_statuses                       | array\|null  | Arreglo de los campos requeridos para cambiar el estado de un lead. Este parámetro solo se retorna al obtener una lista de campos de leads, contactos o compañías.                                                                                                                                                      |
| required\_statuses\[0]                   | object       | Modelo de campo requerido. Este parámetro solo se retorna al obtener una lista de campos de leads, contactos o compañías.                                                                                                                                                                                               |
| required\_statuses\[status\_id]          | int          | ID de la etapa que requiere que el campo actual tenga un valor antes de que el lead pueda ser movido. Este parámetro solo se retorna al obtener una lista de campos de leads, contactos o compañías.                                                                                                                    |
| required\_statuses\[pipeline\_id]        | int          | ID del pipeline que requiere que el campo actual tenga un valor antes de que el lead pueda ser movido. Este parámetro solo se retorna al obtener una lista de campos de leads, contactos o compañías.                                                                                                                   |
| hidden\_statuses                         | array        | Configuración para ocultar campos. Los campos se ocultan en la interfaz de usuario según su etapa en el pipeline. Esta clave solo se devuelve al recuperar la lista de campos de leads                                                                                                                                  |
| hidden\_statuses\[0]                     | object       | Modelo de configuración para ocultar campos                                                                                                                                                                                                                                                                             |
| hidden\_statuses\[0]\[status\_id]        | int          | ID de la etapa en la que el campo está oculto                                                                                                                                                                                                                                                                           |
| hidden\_statuses\[0]\[pipeline\_id]      | int          | ID del pipeline en el que el campo está oculto                                                                                                                                                                                                                                                                          |
| chained\_lists                           | array\|null  | Configuración de un campo de tipo `chained_list`. La clave solo se devuelve al recuperar la lista de campos de leads                                                                                                                                                                                                    |
| chained\_lists\[0]                       | obj          | Modelo de configuración de lista encadenada                                                                                                                                                                                                                                                                             |
| chained\_lists\[0]\[title]               | string\|null | El nombre de la lista encadenada que se muestra en la tarjeta del lead                                                                                                                                                                                                                                                  |
| chained\_lists\[0]\[catalog\_id]         | int          | ID del catálogo                                                                                                                                                                                                                                                                                                         |
| chained\_lists\[0]\[parent\_catalog\_id] | int          | ID del catálogo principal                                                                                                                                                                                                                                                                                               |
| tracking\_callback                       | string       | Una función callback de JavaScript que se ejecuta en la página que contiene un botón de chat y un formulario web de Kommo cuando se envían los datos. Este valor se devuelve para los campos de tipo `tracking_data`.                                                                                                   |
| search\_in                               | string\|null | ID del catálogo o código simbólico (`contacts`, `companies`, `contacts_and_companies`) para un campo de tipo `linked_entity`.                                                                                                                                                                                           |

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "kommo-api",
    "version": "1.0"
  },
  "servers": [
    {
      "url": "https://{subdominio}.kommo.com",
      "variables": {
        "subdominio": {
          "default": "subdominio"
        }
      }
    }
  ],
  "components": {
    "securitySchemes": {
      "sec0": {
        "type": "oauth2",
        "flows": {}
      }
    }
  },
  "security": [
    {
      "sec0": []
    }
  ],
  "paths": {
    "/api/v4/catalogs/{list_id}/custom_fields": {
      "get": {
        "summary": "Lista de campos personalizados de una lista",
        "description": "Este método permite obtener una lista de los campos personalizados de una lista.",
        "operationId": "lista-de-campos-personalizados-de-una-lista",
        "parameters": [
          {
            "name": "list_id",
            "in": "path",
            "description": "ID de la lista",
            "schema": {
              "type": "string"
            },
            "required": true
          },
          {
            "name": "page",
            "in": "query",
            "description": "Página de resultados",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "El número de entidades retornadas por solicitud (límite – 250)",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "order[sort]",
            "in": "query",
            "description": "Ordenamiento de resultados de la lista",
            "schema": {
              "type": "string",
              "enum": [
                "asc",
                "desc"
              ]
            }
          },
          {
            "name": "order[id]",
            "in": "query",
            "description": "Ordenamiento de resultados de la lista",
            "schema": {
              "type": "string",
              "enum": [
                "asc",
                "desc"
              ]
            }
          },
          {
            "name": "filter[type][0]",
            "in": "query",
            "description": "Tipo de campo",
            "schema": {
              "type": "string",
              "enum": [
                "text",
                "numeric",
                "checkbox",
                "select",
                "multiselect",
                "date",
                "url",
                "textarea",
                "radiobutton",
                "streetaddress",
                "smart_address",
                "birthday",
                "date_time",
                "legal_entity",
                "price",
                "category",
                "items"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/hal+json": {
                "examples": {
                  "Solicitud exitosa": {
                    "value": "{\n    \"_total_items\": 2,\n    \"_page\": 1,\n    \"_page_count\": 10,\n    \"_links\": {\n        \"self\": {\n            \"href\": \"https://example.kommo.com/api/v4/leads/custom_fields?limit=2&page=1\"\n        },\n        \"next\": {\n            \"href\": \"https://example.kommo.com/api/v4/leads/custom_fields?limit=2&page=2\"\n        },\n        \"last\": {\n            \"href\": \"https://example.kommo.com/api/v4/leads/custom_fields?limit=2&page=10\"\n        }\n    },\n    \"_embedded\": {\n        \"custom_fields\": [\n            {\n                \"id\": 4439091,\n                \"name\": \"Ejemplo de campo de texto\",\n                \"sort\": 504,\n                \"type\": \"text\",\n                \"is_predefined\": false,\n                \"settings\": null,\n                \"remind\": null,\n                \"is_api_only\": false,\n                \"group_id\": null,\n                \"enums\": null,\n                \"required_statuses\": [\n                    {\n                        \"status_id\": 41221,\n                        \"pipeline_id\": 3142\n                    }\n                ],\n                \"_links\": {\n                    \"self\": {\n                        \"href\": \"https://example.kommo.com/api/v4/custom_fields/4439091/\"\n                    }\n                }\n            },\n            {\n                \"id\": 4440043,\n                \"name\": \"Ejemplo de campo de tipo 'fecha'\",\n                \"sort\": 505,\n                \"type\": \"date\",\n                \"is_predefined\": false,\n                \"settings\": null,\n                \"remind\": null,\n                \"is_api_only\": false,\n                \"group_id\": null,\n                \"enums\": null,\n                \"required_statuses\": null,\n                \"_links\": {\n                    \"self\": {\n                        \"href\": \"https://example.kommo.com/api/v4/custom_fields/4440043/\"\n                    }\n                }\n            }\n        ]\n    }\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "_total_items": {
                      "type": "integer",
                      "example": 2,
                      "default": 0
                    },
                    "_page": {
                      "type": "integer",
                      "example": 1,
                      "default": 0
                    },
                    "_page_count": {
                      "type": "integer",
                      "example": 10,
                      "default": 0
                    },
                    "_links": {
                      "type": "object",
                      "properties": {
                        "self": {
                          "type": "object",
                          "properties": {
                            "href": {
                              "type": "string",
                              "example": "https://example.kommo.com/api/v4/leads/custom_fields?limit=2&page=1"
                            }
                          }
                        },
                        "next": {
                          "type": "object",
                          "properties": {
                            "href": {
                              "type": "string",
                              "example": "https://example.kommo.com/api/v4/leads/custom_fields?limit=2&page=2"
                            }
                          }
                        },
                        "last": {
                          "type": "object",
                          "properties": {
                            "href": {
                              "type": "string",
                              "example": "https://example.kommo.com/api/v4/leads/custom_fields?limit=2&page=10"
                            }
                          }
                        }
                      }
                    },
                    "_embedded": {
                      "type": "object",
                      "properties": {
                        "custom_fields": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "integer",
                                "example": 4439091,
                                "default": 0
                              },
                              "name": {
                                "type": "string",
                                "example": "Ejemplo de campo de texto"
                              },
                              "sort": {
                                "type": "integer",
                                "example": 504,
                                "default": 0
                              },
                              "type": {
                                "type": "string",
                                "example": "text"
                              },
                              "is_predefined": {
                                "type": "boolean",
                                "example": false,
                                "default": true
                              },
                              "settings": {},
                              "remind": {},
                              "is_api_only": {
                                "type": "boolean",
                                "example": false,
                                "default": true
                              },
                              "group_id": {},
                              "enums": {},
                              "required_statuses": {
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "status_id": {
                                      "type": "integer",
                                      "example": 41221,
                                      "default": 0
                                    },
                                    "pipeline_id": {
                                      "type": "integer",
                                      "example": 3142,
                                      "default": 0
                                    }
                                  }
                                }
                              },
                              "_links": {
                                "type": "object",
                                "properties": {
                                  "self": {
                                    "type": "object",
                                    "properties": {
                                      "href": {
                                        "type": "string",
                                        "example": "https://example.kommo.com/api/v4/custom_fields/4439091/"
                                      }
                                    }
                                  }
                                }
                              }
                            }
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad request",
            "content": {
              "application/problem+json": {
                "examples": {
                  "Datos transmitidos inválidos. Detalles disponibles en la solicitud de respuesta": {
                    "value": "{}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {}
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "content": {
              "application/problem+json": {
                "examples": {
                  "El usuario no está autorizado": {
                    "value": "{\n  \"title\": \"Unauthorized\",\n  \"type\": \"https://httpstatus.es/401\",\n  \"status\": 401,\n  \"detail\": \"Nombre de usuario o contraseña incorrectos\"\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": "Nombre de usuario o contraseña incorrectos"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "Unprocessable Entity",
            "content": {
              "application/problem+json": {
                "examples": {
                  "Los datos enviados no pueden procesarse. Los detalles están disponibles en la solicitud de respuesta": {
                    "value": ""
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "x-readme": {
    "headers": [
      {
        "key": "Content-Type",
        "value": "application/json"
      }
    ],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```