> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developer-test.atomicwork.com/llms.txt.
> For full documentation content, see https://developer-test.atomicwork.com/llms-full.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developer-test.atomicwork.com/_mcp/server.

# searchEntitiesByType

Grouped search across entity types (optionally anchored to a source).

Performs a full-text search across multiple entity types and returns results **grouped by entity type**
(e.g., `{REQUEST: [...], CHANGE: [...], ASSET: [...]}`) instead of a flat paginated list. **Same search engine as `searchEntities`** — both hit the same Elasticsearch-backed query pipeline.

## Parameters

| Name                 | Type                   | Required | Description                                                                                                               |
| -------------------- | ---------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------- |
| `per_page`           | integer                | No       | Default: `25`.                                                                                                            |
| `page`               | integer                | Yes      | Default: `1`.                                                                                                             |
| `sort_order`         | BaseSearchSortOrder    | No       |                                                                                                                           |
| `source_display_id`  | string                 | No       | Display ID of the source entity for link-candidate mode (e.g., REQ-123). When provided, the source and its already-linke  |
| `source_entity_type` | `REQUEST` \| `CHANGE`  | No       | Entity type of the source entity. Required if `source_display_id` is provided.                                            |
| `reference_key`      | string                 | No       | Relationship reference key (e.g., "parent\_child", "relates", "blocks"). When combined with a source, further filters alr |
| `search_type`        | object                 | No       |                                                                                                                           |
| `search_components`  | object                 | No       |                                                                                                                           |
| `query`              | string                 | No       |                                                                                                                           |
| `per_page`           | integer                | No       | Default: `10`.                                                                                                            |
| `page`               | integer                | No       | Default: `1`.                                                                                                             |
| `filters`            | SearchBaseFilterDTO\[] | No       |                                                                                                                           |