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"
]
}
]
}