---
title: "Search entities"
method: GET
path: "/entities/search"
tags: ["Entities"]
---

# Search entities

`GET /entities/search`

Search and filter entities using various criteria

## Query parameters

- `query` string
- `tag` string
- `entity_types[]` string[]
- `sort` 'name' | 'client_id_number' | 'entity_type' | 'primary_contact' | 'created_at' | 'updated_at'
- `direction` 'asc' | 'desc'
- `query_type` 'and' | 'or'
- `filters` object[]
  - `type` 'enum', required — Filter type (use 'enum' for tag filters)
  - `field` 'tags', required — Field to filter on (currently only tags supported)
  - `criteria` 'has_any_of' | 'has_all_of' | 'has_none_of', required — Tag filter criteria
  - `values` string[], required — Array of tag names

## Response `200`

Successful response with filtered entities

- object
  - `data` object[]

---

[API](https://skmtc.net/gettruss/apis/api-v1.md) · [All operations](https://skmtc.net/gettruss/apis/api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gettruss/api-v1/versions/7c956b3d1bdf/schema)