Get

[POST] .../v1/filterfield/get

Returns filterable fields for the selected entity. Use this method before constructing dynamic filters for an API entity when the client needs the machine-readable list of allowed field names. The request requires entity_type in filters and returns standard filter fields plus custom additional fields when that entity and tariff support them. Selection control fields such as search, filters, sort_orders, limit and offset are excluded from the returned filterable fields. Use ItemExt as entity_type to get the filter fields for Item/GetExt. Missing body, invalid or unsupported entity_type, unavailable additional-fields tariff option, metadata provider errors and storage failures are returned as HTTP 200 ErrorResult business errors.

Request Parameters

Name Type Required Description
filters Array of Filter Required Filters by fields available for this API method. Required filter fields: entity_type.

Filterable Fields

Field Type Required Description
entity_type string Required Entity whose filterable fields should be returned.

Request Example

{
  "filters": [
    {
      "field": "entity_type",
      "operator": "Equal",
      "value": "Item"
    }
  ]
}

Response Parameters

Name Type Description
ok Boolean Indicates whether the request completed successfully.
result Array of FilterField Result array.

Response Example

{
  "ok": true,
  "result": [
    {
      "field": "id",
      "datatype": "int",
      "filter_type": "Number",
      "multiple": true,
      "operators": [
        "Equal",
        "In"
      ]
    },
    {
      "field": "name",
      "datatype": "string",
      "filter_type": "Text",
      "multiple": false,
      "operators": [
        "Equal",
        "Like"
      ]
    }
  ]
}