> 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/user-search-filters.md).

# User Search Filters

## Show user search filter

> Returns a saved search filter by ID.\
> \
> The response includes the filter name, owner, global flag, and criteria that can be reused in a search.\
> \
> This endpoint loads the filter by ID and does not apply the owner-only restriction used by other endpoints.<br>

```json
{"openapi":"3.0.0","info":{"title":"td-bg","version":"Truedat 8.11.0"},"paths":{"/api/business_concept_user_filters/{id}":{"get":{"description":"Returns a saved search filter by ID.\n\nThe response includes the filter name, owner, global flag, and criteria that can be reused in a search.\n\nThis endpoint loads the filter by ID and does not apply the owner-only restriction used by other endpoints.\n","operationId":"TdBgWeb.UserSearchFilterController.show","parameters":[{"description":"User search filter ID","in":"path","name":"id","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserSearchFilterShowResponse"}}},"description":"User search filter"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdBgUnauthorizedResponse"}}},"description":"Unauthorized"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdBgNotFoundResponse"}}},"description":"Not found"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdBgInternalServerErrorResponse"}}},"description":"Internal Server Error"}},"summary":"Show user search filter","tags":["User Search Filters"]}}},"components":{"schemas":{"UserSearchFilterShowResponse":{"properties":{"data":{"additionalProperties":true,"type":"object"}},"title":"UserSearchFilterShowResponse","type":"object"},"TdBgUnauthorizedResponse":{"properties":{"errors":{"properties":{"message":{"type":"string"}},"type":"object"}},"title":"TdBgUnauthorizedResponse","type":"object"},"TdBgNotFoundResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdBgNotFoundResponse","type":"object"},"TdBgInternalServerErrorResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdBgInternalServerErrorResponse","type":"object"}}}}
```

## Delete user search filter (only owner)

> Deletes a saved search filter. Only the owner of the filter can remove it.

```json
{"openapi":"3.0.0","info":{"title":"td-bg","version":"Truedat 8.11.0"},"paths":{"/api/business_concept_user_filters/{id}":{"delete":{"description":"Deletes a saved search filter. Only the owner of the filter can remove it.","operationId":"TdBgWeb.UserSearchFilterController.delete","parameters":[{"description":"User search filter ID","in":"path","name":"id","required":true,"schema":{"type":"integer"}}],"responses":{"204":{"description":"User search filter deleted"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdBgUnauthorizedResponse"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdBgForbiddenResponse"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdBgNotFoundResponse"}}},"description":"Not found"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdBgInternalServerErrorResponse"}}},"description":"Internal Server Error"}},"summary":"Delete user search filter (only owner)","tags":["User Search Filters"]}}},"components":{"schemas":{"TdBgUnauthorizedResponse":{"properties":{"errors":{"properties":{"message":{"type":"string"}},"type":"object"}},"title":"TdBgUnauthorizedResponse","type":"object"},"TdBgForbiddenResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdBgForbiddenResponse","type":"object"},"TdBgNotFoundResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdBgNotFoundResponse","type":"object"},"TdBgInternalServerErrorResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdBgInternalServerErrorResponse","type":"object"}}}}
```

## List user search filters for current user

> Returns the search filters owned by the authenticated user, plus any global filters.\
> \
> The result set is the union of:\
> \- filters owned by the caller (\`user\_id\` matches), and\
> \- filters flagged as \`is\_global\`.\
> \
> When the caller is a non-admin \`jti\` user, the result is further filtered by domain: filters whose \`filters.taxonomy\` does not intersect with the caller's permitted domains under \*\*'View published business concepts'\*\* are excluded.\
> \
> If the caller has no \*\*'View published business concepts'\*\* permission in any domain and the permission is not granted by default, the response is empty.<br>

```json
{"openapi":"3.0.0","info":{"title":"td-bg","version":"Truedat 8.11.0"},"paths":{"/api/business_concept_user_filters/me":{"get":{"description":"Returns the search filters owned by the authenticated user, plus any global filters.\n\nThe result set is the union of:\n- filters owned by the caller (`user_id` matches), and\n- filters flagged as `is_global`.\n\nWhen the caller is a non-admin `jti` user, the result is further filtered by domain: filters whose `filters.taxonomy` does not intersect with the caller's permitted domains under **'View published business concepts'** are excluded.\n\nIf the caller has no **'View published business concepts'** permission in any domain and the permission is not granted by default, the response is empty.\n","operationId":"TdBgWeb.UserSearchFilterController.index_by_user","parameters":[],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserSearchFilterIndexByUserResponse"}}},"description":"User search 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 user search filters for current user","tags":["User Search Filters"]}}},"components":{"schemas":{"UserSearchFilterIndexByUserResponse":{"properties":{"data":{"items":{"additionalProperties":true,"type":"object"},"type":"array"}},"title":"UserSearchFilterIndexByUserResponse","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 all user search filters

> Returns all saved user search filters in the system.\
> \
> The response includes filters owned by any user, including global filters.\
> \
> To list only the caller's own filters plus globals, use the \`index\_by\_user\` endpoint instead.<br>

```json
{"openapi":"3.0.0","info":{"title":"td-bg","version":"Truedat 8.11.0"},"paths":{"/api/business_concept_user_filters":{"get":{"description":"Returns all saved user search filters in the system.\n\nThe response includes filters owned by any user, including global filters.\n\nTo list only the caller's own filters plus globals, use the `index_by_user` endpoint instead.\n","operationId":"TdBgWeb.UserSearchFilterController.index","parameters":[],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserSearchFilterIndexResponse"}}},"description":"User search 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 all user search filters","tags":["User Search Filters"]}}},"components":{"schemas":{"UserSearchFilterIndexResponse":{"properties":{"data":{"items":{"additionalProperties":true,"type":"object"},"type":"array"}},"title":"UserSearchFilterIndexResponse","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"}}}}
```

## Create user search filter

> Creates a saved search filter for the authenticated user.\
> \
> Set \`is\_global\` to \`true\` only when the caller is allowed to create a global filter; it defaults to \`false\` when omitted.<br>

```json
{"openapi":"3.0.0","info":{"title":"td-bg","version":"Truedat 8.11.0"},"paths":{"/api/business_concept_user_filters":{"post":{"description":"Creates a saved search filter for the authenticated user.\n\nSet `is_global` to `true` only when the caller is allowed to create a global filter; it defaults to `false` when omitted.\n","operationId":"TdBgWeb.UserSearchFilterController.create","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserSearchFilterCreateRequest"}}},"description":"User search filter payload","required":false},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserSearchFilterCreateResponse"}}},"description":"User search filter created"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdBgUnauthorizedResponse"}}},"description":"Unauthorized"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdBgUnprocessableEntityFiltersResponse"}}},"description":"Unprocessable Entity"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdBgInternalServerErrorResponse"}}},"description":"Internal Server Error"}},"summary":"Create user search filter","tags":["User Search Filters"]}}},"components":{"schemas":{"UserSearchFilterCreateRequest":{"additionalProperties":false,"properties":{"user_search_filter":{"additionalProperties":false,"properties":{"filters":{"additionalProperties":true,"description":"Search criteria that can be supplied to the business concept search endpoint.","type":"object"},"is_global":{"default":false,"description":"Whether the saved filter is available globally. Defaults to `false`.","type":"boolean"},"name":{"type":"string"}},"required":["name","filters"],"type":"object"}},"required":["user_search_filter"],"title":"UserSearchFilterCreateRequest","type":"object"},"UserSearchFilterCreateResponse":{"properties":{"data":{"additionalProperties":true,"type":"object"}},"title":"UserSearchFilterCreateResponse","type":"object"},"TdBgUnauthorizedResponse":{"properties":{"errors":{"properties":{"message":{"type":"string"}},"type":"object"}},"title":"TdBgUnauthorizedResponse","type":"object"},"TdBgUnprocessableEntityFiltersResponse":{"properties":{"errors":{"properties":{"filters":{"type":"array"},"name":{"type":"array"}},"type":"object"}},"title":"TdBgUnprocessableEntityFiltersResponse","type":"object"},"TdBgInternalServerErrorResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdBgInternalServerErrorResponse","type":"object"}}}}
```
