> For the complete documentation index, see [llms.txt](https://docs.truedat.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.truedat.io/api-integrations/business-glossary-apis/business-concept-filters.md).

# Business Concept Filters

## Search business concept filters

> Returns filter values and counts calculated from business concept versions visible to the authenticated user and matching the supplied criteria.\
> \
> Omitted criteria do not restrict the aggregation. Send an empty request body to obtain the same result as the general filter listing.<br>

```json
{"openapi":"3.0.0","info":{"title":"td-bg","version":"Truedat 8.11.0"},"paths":{"/api/business_concept_filters/search":{"post":{"description":"Returns filter values and counts calculated from business concept versions visible to the authenticated user and matching the supplied criteria.\n\nOmitted criteria do not restrict the aggregation. Send an empty request body to obtain the same result as the general filter listing.\n","operationId":"TdBgWeb.BusinessConceptFilterController.search","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BusinessConceptFilterSearchRequest"}}},"description":"Business concept filter search payload","required":false},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BusinessConceptFilterShowResponse"}}},"description":"Business concept filters"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdBgUnauthorizedResponse"}}},"description":"Unauthorized"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdBgInternalServerErrorResponse"}}},"description":"Internal Server Error"}},"summary":"Search business concept filters","tags":["Business Concept Filters"]}}},"components":{"schemas":{"BusinessConceptFilterSearchRequest":{"additionalProperties":true,"properties":{"confidential":{"description":"Filter by confidential flag","nullable":true,"type":"boolean"},"domain_ids":{"description":"Filter by domain IDs","items":{"type":"integer"},"nullable":true,"type":"array"},"status":{"description":"Filter by business concept statuses","items":{"enum":["published","draft","deprecated","versioned"],"type":"string"},"nullable":true,"type":"array"},"text":{"description":"Full-text search term","nullable":true,"type":"string"},"type":{"description":"Filter by business concept types","items":{"type":"string"},"nullable":true,"type":"array"}},"title":"BusinessConceptFilterSearchRequest","type":"object"},"BusinessConceptFilterShowResponse":{"additionalProperties":false,"properties":{"data":{"additionalProperties":{"$ref":"#/components/schemas/Filter"},"description":"Available filter values grouped by filter name","type":"object"}},"required":["data"],"title":"BusinessConceptFilterShowResponse","type":"object"},"Filter":{"additionalProperties":false,"properties":{"buckets":{"description":"Available values and their counts.","items":{"$ref":"#/components/schemas/FilterBucket"},"type":"array"},"values":{"description":"List of distinct values","items":{},"type":"array"}},"required":["buckets","values"],"title":"Filter","type":"object"},"FilterBucket":{"additionalProperties":false,"properties":{"doc_count":{"description":"Number of visible business concept versions matching this value.","type":"integer"},"key":{"description":"Filter value represented by this bucket.","type":"string"}},"required":["key"],"title":"FilterBucket","type":"object"},"TdBgUnauthorizedResponse":{"properties":{"errors":{"properties":{"message":{"type":"string"}},"type":"object"}},"title":"TdBgUnauthorizedResponse","type":"object"},"TdBgInternalServerErrorResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdBgInternalServerErrorResponse","type":"object"}}}}
```

## List business concept filters

> Returns available business concept filter values and their counts.\
> \
> The aggregation is calculated over business concept versions visible to the authenticated user, including status, domain, confidentiality, and template-specific visibility rules.<br>

```json
{"openapi":"3.0.0","info":{"title":"td-bg","version":"Truedat 8.11.0"},"paths":{"/api/business_concept_filters":{"get":{"description":"Returns available business concept filter values and their counts.\n\nThe aggregation is calculated over business concept versions visible to the authenticated user, including status, domain, confidentiality, and template-specific visibility rules.\n","operationId":"TdBgWeb.BusinessConceptFilterController.index","parameters":[],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BusinessConceptFilterShowResponse"}}},"description":"Business concept filters"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdBgUnauthorizedResponse"}}},"description":"Unauthorized"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdBgInternalServerErrorResponse"}}},"description":"Internal Server Error"}},"summary":"List business concept filters","tags":["Business Concept Filters"]}}},"components":{"schemas":{"BusinessConceptFilterShowResponse":{"additionalProperties":false,"properties":{"data":{"additionalProperties":{"$ref":"#/components/schemas/Filter"},"description":"Available filter values grouped by filter name","type":"object"}},"required":["data"],"title":"BusinessConceptFilterShowResponse","type":"object"},"Filter":{"additionalProperties":false,"properties":{"buckets":{"description":"Available values and their counts.","items":{"$ref":"#/components/schemas/FilterBucket"},"type":"array"},"values":{"description":"List of distinct values","items":{},"type":"array"}},"required":["buckets","values"],"title":"Filter","type":"object"},"FilterBucket":{"additionalProperties":false,"properties":{"doc_count":{"description":"Number of visible business concept versions matching this value.","type":"integer"},"key":{"description":"Filter value represented by this bucket.","type":"string"}},"required":["key"],"title":"FilterBucket","type":"object"},"TdBgUnauthorizedResponse":{"properties":{"errors":{"properties":{"message":{"type":"string"}},"type":"object"}},"title":"TdBgUnauthorizedResponse","type":"object"},"TdBgInternalServerErrorResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdBgInternalServerErrorResponse","type":"object"}}}}
```
