> 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/v8.8/api-integrations/business-glossary-apis/business-concept-filters.md).

# Business Concept Filters

## Search business concept filters

> Search available filters for business concepts based on request criteria.

```json
{"openapi":"3.0.0","info":{"title":"td-bg","version":"Truedat 8.8.0"},"paths":{"/api/business_concept_filters/search":{"post":{"description":"Search available filters for business concepts based on request criteria.","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":"Aggregation buckets","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 documents matching this bucket","type":"integer"},"key":{"description":"Bucket key (value of the filter)","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

> Retrieve available business concept filters for the authenticated user.

```json
{"openapi":"3.0.0","info":{"title":"td-bg","version":"Truedat 8.8.0"},"paths":{"/api/business_concept_filters":{"get":{"description":"Retrieve available business concept filters for the authenticated user.","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":"Aggregation buckets","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 documents matching this bucket","type":"integer"},"key":{"description":"Bucket key (value of the filter)","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"}}}}
```
