# System-wide search | Copenhagen Truck Wash API

### Copenhagen Truck Wash API Help

# System-wide search

This endpoint documentation is generated directly from `openapi.yaml`.

## Endpoint

GET /search/system

## Operation

Operation ID: `systemWideSearchGet`

Search across all supported entities with permission-aware filtering and optional intent parsing debug metadata. Customer records and customer-related entities are matched against a local e-conomic customer index (name/address/email/CVR) that is refreshed by cron. Intent parsing is invoked adaptively when lexical confidence is low or when the query looks intent-driven. Results are ordered by relevance, with recent records preferred when relevance is comparable.

## Authentication

Security requirements:

Scheme | Scopes
--- | ---
BearerAuth | -

## Parameters

Name | In | Required | Type | Description
--- | --- | --- | --- | ---
query | query | yes | string | Free-text query to search for. Supports natural-language intent fallback and domain synonyms such as `rabat` -> `discount`.
include_types | query | no | array<SystemSearchEntityType> | Comma-separated list of entity types to include. Defaults to all allowed types.
exclude_types | query | no | array<SystemSearchEntityType> | Comma-separated list of entity types to exclude.
include_associations | query | no | boolean | Include associated objects when matching a primary entity such as a customer.
debug_intent | query | no | boolean | Include intent parser diagnostics in `meta.intent_parser`.
limit | query | no | integer |
offset | query | no | integer |

## Responses

Status | Description | Content Types
--- | --- | ---
200 | Search results returned successfully | application/json
400 |  |
401 |  |
403 |  |

Schema for response `200` (`application/json`):

{ "$ref": "#/components/schemas/SystemSearchResponse" }
17 March 2026