---
title: "Search Units"
method: POST
path: "/unit/_search"
tags: ["Unit"]
---

# Search Units

`POST /unit/_search`

Search for `Units` with filtering capabilities.

## Query parameters

- `limit` integer
- `offset` integer

## Request body

- object
  - `filter` UnitFilter, required — Filter object for Unit
    - `equals` UnitFilterEquals — Equality/Inequality filter fields for Unit
      - `id` string, uuid, nullable — Unique identifier for the Unit
      - `meta` MetaFilterEquals — Equality/Inequality filter fields for Meta
        - `createdAt` string, date-time, nullable — Timestamp when the resource was created
        - `createdBy` string, uuid, nullable — User who created the resource
        - `updatedAt` string, date-time, nullable — Timestamp when the resource was last updated
        - `updatedBy` string, uuid, nullable — User who last updated the resource
      - `external` ExternalFilterEquals — Equality/Inequality filter fields for External
        - `sourceID` string, nullable — The ID of the external source
        - `source` string, nullable — The source of the external information
      - `title` string, nullable — The title of the unit
      - `description` string, nullable — The description of the unit
    - `notEquals` UnitFilterEquals — Equality/Inequality filter fields for Unit
      - `id` string, uuid, nullable — Unique identifier for the Unit
      - `meta` MetaFilterEquals — Equality/Inequality filter fields for Meta
        - `createdAt` string, date-time, nullable — Timestamp when the resource was created
        - `createdBy` string, uuid, nullable — User who created the resource
        - `updatedAt` string, date-time, nullable — Timestamp when the resource was last updated
        - `updatedBy` string, uuid, nullable — User who last updated the resource
      - `external` ExternalFilterEquals — Equality/Inequality filter fields for External
        - `sourceID` string, nullable — The ID of the external source
        - `source` string, nullable — The source of the external information
      - `title` string, nullable — The title of the unit
      - `description` string, nullable — The description of the unit
    - `greaterThan` UnitFilterRange — Range filter fields for Unit
      - `meta` MetaFilterRange — Range filter fields for Meta
        - `createdAt` string, date-time, nullable — Timestamp when the resource was created
        - `updatedAt` string, date-time, nullable — Timestamp when the resource was last updated
      - `external` ExternalFilterRange — Range filter fields for External
    - `smallerThan` UnitFilterRange — Range filter fields for Unit
      - `meta` MetaFilterRange — Range filter fields for Meta
        - `createdAt` string, date-time, nullable — Timestamp when the resource was created
        - `updatedAt` string, date-time, nullable — Timestamp when the resource was last updated
      - `external` ExternalFilterRange — Range filter fields for External
    - `greaterOrEqual` UnitFilterRange — Range filter fields for Unit
      - `meta` MetaFilterRange — Range filter fields for Meta
        - `createdAt` string, date-time, nullable — Timestamp when the resource was created
        - `updatedAt` string, date-time, nullable — Timestamp when the resource was last updated
      - `external` ExternalFilterRange — Range filter fields for External
    - `smallerOrEqual` UnitFilterRange — Range filter fields for Unit
      - `meta` MetaFilterRange — Range filter fields for Meta
        - `createdAt` string, date-time, nullable — Timestamp when the resource was created
        - `updatedAt` string, date-time, nullable — Timestamp when the resource was last updated
      - `external` ExternalFilterRange — Range filter fields for External
    - `contains` UnitFilterContains — Contains filter fields for Unit
      - `id` string[] — Unique identifier for the Unit
      - `meta` MetaFilterContains — Contains filter fields for Meta
        - `createdBy` string[] — User who created the resource
        - `updatedBy` string[] — User who last updated the resource
      - `external` ExternalFilterContains — Contains filter fields for External
        - `sourceID` string[] — The ID of the external source
        - `source` string[] — The source of the external information
      - `title` string[] — The title of the unit
      - `description` string[] — The description of the unit
    - `notContains` UnitFilterContains — Contains filter fields for Unit
      - `id` string[] — Unique identifier for the Unit
      - `meta` MetaFilterContains — Contains filter fields for Meta
        - `createdBy` string[] — User who created the resource
        - `updatedBy` string[] — User who last updated the resource
      - `external` ExternalFilterContains — Contains filter fields for External
        - `sourceID` string[] — The ID of the external source
        - `source` string[] — The source of the external information
      - `title` string[] — The title of the unit
      - `description` string[] — The description of the unit
    - `like` UnitFilterLike — LIKE filter fields for Unit
      - `meta` MetaFilterLike — LIKE filter fields for Meta
      - `external` ExternalFilterLike — LIKE filter fields for External
        - `sourceID` string, nullable — The ID of the external source
        - `source` string, nullable — The source of the external information
      - `title` string, nullable — The title of the unit
      - `description` string, nullable — The description of the unit
    - `notLike` UnitFilterLike — LIKE filter fields for Unit
      - `meta` MetaFilterLike — LIKE filter fields for Meta
      - `external` ExternalFilterLike — LIKE filter fields for External
        - `sourceID` string, nullable — The ID of the external source
        - `source` string, nullable — The source of the external information
      - `title` string, nullable — The title of the unit
      - `description` string, nullable — The description of the unit
    - `null` UnitFilterNull — Null filter fields for Unit
      - `meta` MetaFilterNull — Null filter fields for Meta
        - `createdBy` boolean, nullable — User who created the resource
        - `updatedAt` boolean, nullable — Timestamp when the resource was last updated
        - `updatedBy` boolean, nullable — User who last updated the resource
      - `external` ExternalFilterNull — Null filter fields for External
        - `sourceID` boolean, nullable — The ID of the external source
        - `source` boolean, nullable — The source of the external information
      - `description` boolean, nullable — The description of the unit
    - `notNull` UnitFilterNull — Null filter fields for Unit
      - `meta` MetaFilterNull — Null filter fields for Meta
        - `createdBy` boolean, nullable — User who created the resource
        - `updatedAt` boolean, nullable — Timestamp when the resource was last updated
        - `updatedBy` boolean, nullable — User who last updated the resource
      - `external` ExternalFilterNull — Null filter fields for External
        - `sourceID` boolean, nullable — The ID of the external source
        - `source` boolean, nullable — The source of the external information
      - `description` boolean, nullable — The description of the unit
    - `orCondition` boolean, required — OrCondition decides if this filter is within an OR-condition or AND-condition
    - `nestedFilters` UnitFilter[] — NestedFilters of the Unit, useful for more complex filters

## Response `200`

Response for Unit Search operation - returns filtered Unit results

- object
  - `data` Unit[] — Array of Unit objects
    - `id` string, uuid, required — Unique identifier for the Unit
    - `meta` Meta — Meta contains information about the creation and modification of a resource for auditing purposes
      - `createdAt` string, date-time, required — Timestamp when the resource was created
      - `createdBy` string, uuid, nullable — User who created the resource
      - `updatedAt` string, date-time, nullable — Timestamp when the resource was last updated
      - `updatedBy` string, uuid, nullable — User who last updated the resource
    - `external` External — External is a reusable object that can be used to store external information from another system, used for third-party integration tracking.
      - `sourceID` string, nullable — The ID of the external source
      - `source` string, nullable — The source of the external information
    - `title` string, required — The title of the unit
    - `description` string, nullable — The description of the unit
  - `pagination` Pagination — Pagination parameters for controlling result sets in list operations
    - `offset` integer, required — Number of items to skip from the beginning of the result set
    - `limit` integer, required — Maximum number of items to return in the result set
    - `total` integer, required — Total number of items available for pagination

## Other responses

- `400` — Bad Request - The request was malformed or contained invalid parameters
- `401` — Unauthorized - The request is missing valid authentication credentials
- `403` — Forbidden - Request is authenticated, but the user is not allowed to perform the operation
- `404` — Not Found - The requested resource does not exist
- `409` — Conflict - The request could not be completed due to a conflict
- `422` — Validation error for Unit Search operation - request data failed validation
- `429` — Too Many Requests - When the rate limit has been exceeded
- `500` — Internal Server Error - An unexpected server error occurred

---

[API](https://skmtc.net/meitner/apis/directory-api.md) · [All operations](https://skmtc.net/meitner/apis/directory-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/meitner/directory-api/revisions/014348a7bc35/schema)