Primitive
atom.findByDataCriteria
BETAShort name: findByDataCriteria
Version: 1.0.0
List atoms by top-level data field presence and optional primitive value equality.
Back to primitive libraryInputs
| Key | Type | Required | Description |
|---|---|---|---|
| andEquals | object | false | Optional additional top-level field equality filters AND-ed with the primary field filter. |
| equals | any | false | Optional primitive value equality filter. |
| fieldName | string | true | Top-level atom.data field key to evaluate. |
| lexemeId | objectId | false | Optional lexeme filter. |
| limit | number | false | Results per page (default 20, max 100 in helper). |
| organizationAtomId | objectId | false | Optional organization owner filter. |
| page | number | false | 1-indexed page number. |
| presence | string | false | Field presence mode: "present" (default) or "missing". |
| scope | string | false | Visibility scope: "own", "share", or "all". |
Outputs
| Key | Type | Required | Description |
|---|---|---|---|
| atoms | array | false | Serialized atoms matching criteria. |
| pagination | object | false | Pagination metadata: { page, limit, total, totalPages }. |