---
title: "Suggest Record Filters"
method: POST
path: "/api/v1/ontology/entities/{entity_id}/search-suggestions"
tags: ["ontology-query"]
---

# Suggest Record Filters

`POST /api/v1/ontology/entities/{entity_id}/search-suggestions`

## Request

- Base URL: `https://api.netter.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.netter.ai/api/v1/ontology/entities/{entity_id}/search-suggestions`
- Auth: none declared

Live scalar-value suggestions, counted over caller-visible anchor records.

Automatic search covers bounded properties on the entity and direct links;
coverage_limited reports wider schemas. Explicit column selection searches
that property's full value set. Values over 512 characters are not suggested.

## Path parameters

- `entity_id` string, uuid, required

## Request body

- RecordFilterSuggestionsRequest
  - `filters` RecordSuggestionScopeFilter[]
    - `column` string, required
    - `relationship_id` string, uuid, nullable
    - `operator` 'contains' | 'equals' | 'empty' | 'not-empty', required
    - `value` string
  - `query` string
  - `column` string, nullable
  - `relationship_id` string, uuid, nullable
  - `search` string
  - `limit` integer

## Response `200`

Successful Response

- RecordFilterSuggestionsResponse
  - `suggestions` RecordFilterSuggestion[]
    - `column` string, required
    - `label` string, required
    - `entity_id` string, uuid, required
    - `entity_label` string, required
    - `relationship_id` string, uuid, nullable
    - `relationship_label` string, nullable
    - `value` string, nullable, required
    - `count` integer, required
  - `searched_properties` integer
  - `total_properties` integer
  - `coverage_limited` boolean
  - `has_more` boolean

## Other responses

- `422`: Validation Error

## Changes

> 60 revisions in range; 1 not diffed.

- **2026-11-01** `8712215ec520`: 2 info
  - added the new optional request property `filters`
  - the `search` request property's maxLength was increased from `200` to `500`
- **2026-10-31** `dd0e91419f71`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/netter/apis/dmi-backend/changes/api/v1/ontology/entities/:entity_id/search-suggestions/post.md)

---

[API](https://skmtc.dev/netter/apis/dmi-backend.md) - [All operations](https://skmtc.dev/netter/apis/dmi-backend/llms.txt) - [OpenAPI document](https://skmtc.dev/netter/apis/dmi-backend/revisions/29c68bd8ba7b?raw)