Skip to main content

JSON: Find By Key

Find the first object in a JSON array whose Key field equals the value flowing in on the filter input, then emit the matched object on value. Useful for "lookup row by id" patterns — the JSON-array equivalent of a primary-key lookup. Matching uses exact JSON equality, and array elements that are not objects (or lack the Key field) are skipped.

Example
Key: "id"
Array:  [{"id": 1, ...}, {"id": 2, "name": "bob"}, {"id": 3, ...}]
Filter: 2
Output: {"id": 2, "name": "bob"}

Parameters​

Keyrequired

Field name on each array element to compare against the filter value.

Skip if not found

When enabled, missing matches soft-skip the step (no output, no failure). When disabled (default), a no-match fails the step. The flag also soft-skips invalid-input errors (e.g. a non-array on the Array input).

Input​

Arrayrequired
JSON array of objects to search.
Filterrequired

The Number or String value to compare against each element's Key field.

Output​

JSON Element
The first matching object.