---
title: "Search resources by custom field"
method: POST
path: "/v1/custom-fields/search"
tags: ["Custom Field"]
---

# Search resources by custom field

`POST /v1/custom-fields/search`

Return permission-filtered resource IDs matching an indexed custom-field predicate.

## Request body

- object
  - `definition_id` string, required
  - `op` 'eq' | 'gt' | 'gte' | 'lt' | 'lte' | 'match', required
  - `text` string
  - `integer` integer
  - `decimal` string
  - `boolean` boolean
  - `date` string, date
  - `datetime` string, date-time
  - `url` string
  - `option_key` string
  - `user_id` string
  - `resource_id` string
  - `limit` integer

## Response `200`

OK

- CustomFieldSearchResult
  - `resource_ids` string[], required

## Other responses

- `400` — Bad request
- `401` — Unauthorized request
- `403` — Forbidden
- `404` — The requested resource not found
- `500` — Internal Server Error

## Changes

- **2026-09-02** `605ffe113d3d` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/opcotech/apis/elemo-api/changes/v1/custom-fields/search/post.md)

---

[API](https://skmtc.dev/opcotech/apis/elemo-api.md) · [All operations](https://skmtc.dev/opcotech/apis/elemo-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/opcotech/elemo-api/revisions/605ffe113d3d/schema)
