v1

latestOpenAPI 3.1.02026-07-261620662.2 KB

Lista de campos personalizados de uma lista

Este método permite obter uma lista de campos personalizados de uma lista.

get/api/v4/catalogs/{list_id}/custom_fields

Path parameters

list_idinteger required

ID da lista

Query parameters

pageinteger

Página de resultado

limitinteger

Número de entidades retornadas por solicitação (limite – 250)

order[sort]'asc' | 'desc'

Ordenação dos resultados da lista

order[id]'asc' | 'desc'

Ordenação dos resultados da 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": "Exemplo 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/"
          }
        }
      }
    ]
  }
}