Sign in

v1

latestOpenAPI 3.1.02026-07-261630686.8 KB

Lista de campos personalizados

Este método permite obtener una lista de campos personalizados en la cuenta (leads, compañías, contactos).

get/api/v4/{entity_type}/custom_fields

Path parameters

entity_type'leads' | 'companies' | 'contacts' required

Tipo de entidad

Query parameters

pageinteger

Página de resultados

limitinteger

El número de entidades retornadas por solicitud (límite – 250)

order[sort]'asc' | 'desc'

Ordenamiento de resultados de la lista

order[id]'asc' | 'desc'

Ordenamiento de resultados de la lista

filter[type][0]'text' | 'numeric' | 'checkbox' | 'select' | 'multiselect' | 'date' | 'url' | 'textarea' | 'radiobutton' | 'streetaddress' | 'smart_address' | 'birthday' | 'date_time' | 'legal_entity' | 'price' | 'category' | 'items'

Tipo de campo

Response

200

_total_itemsinteger
_pageinteger
_page_countinteger

Example response

{
  "_total_items": 2,
  "_page": 1,
  "_page_count": 10,
  "_links": {
    "self": {
      "href": "https://example.kommo.com/api/v4/leads/custom_fields?limit=2&page=1"
    },
    "next": {
      "href": "https://example.kommo.com/api/v4/leads/custom_fields?limit=2&page=2"
    },
    "last": {
      "href": "https://example.kommo.com/api/v4/leads/custom_fields?limit=2&page=10"
    }
  },
  "_embedded": {
    "custom_fields": [
      {
        "id": 4439091,
        "name": "Ejemplo de campo de texto",
        "sort": 504,
        "type": "text",
        "required_statuses": [
          {
            "status_id": 41221,
            "pipeline_id": 3142
          }
        ],
        "_links": {
          "self": {
            "href": "https://example.kommo.com/api/v4/custom_fields/4439091/"
          }
        }
      }
    ]
  }
}