---
title: FIND
url: https://www.tines.com/docs/formulas/functions/find/
kind: formula-function
---

*[tines.com](https://www.tines.com/llms.txt) › [Docs](https://www.tines.com/docs/llms.txt) › [Formulas](https://www.tines.com/llm/docs/formulas.md) › [Functions](https://www.tines.com/llm/docs/formulas/functions.md)*

# FIND

*[View on tines.com](https://www.tines.com/docs/formulas/functions/find/)*

Returns the first element in the array for which the lambda returns true.

**Categories:** Lambdas, Arrays

## Syntax

```
FIND(array, LAMBDA(item, [expr]))
```

## Examples

### Example 1

Input:

```json
{
  "my_array": [
    {
      "animal": "bee",
      "type": "insect"
    },
    {
      "animal": "cat",
      "type": "mammal"
    },
    {
      "animal": "dog",
      "type": "mammal"
    }
  ]
}
```

Formula:

```
FIND(my_array, LAMBDA(item, item.type = 'mammal'))
```

Output:

```json
{
  "animal": "cat",
  "type": "mammal"
}
```

### Example 2

Input:

```json
{
  "my_array": [
    {
      "animal": "bee",
      "type": "insect"
    },
    {
      "animal": "cat",
      "type": "mammal"
    },
    {
      "animal": "dog",
      "type": "mammal"
    }
  ]
}
```

Formula:

```
FIND(my_array, LAMBDA(item, item.type = 'fish'))
```

Output:

```json
null
```

## Sample actions

```json
{
  "standardLibVersion": "13",
  "actionRuntimeVersion": "2",
  "agents": [
    {
      "disabled": false,
      "name": "My Action",
      "description": "",
      "options": {
        "mode": "message_only",
        "loop": false,
        "payload": {
          "my_array": [
            {
              "animal": "bee",
              "type": "insect"
            },
            {
              "animal": "cat",
              "type": "mammal"
            },
            {
              "animal": "dog",
              "type": "mammal"
            }
          ]
        }
      },
      "position": {
        "x": 2655,
        "y": 2385
      },
      "type": "eventTransformation",
      "timeSavedUnit": "minutes",
      "timeSavedValue": 0,
      "monitorAllEvents": false,
      "monitorFailures": false,
      "monitorNoEventsEmitted": null,
      "form": null
    },
    {
      "disabled": false,
      "name": "FIND",
      "description": "",
      "options": {
        "mode": "message_only",
        "loop": false,
        "payload": {
          "find": "=FIND(my_action.my_array, LAMBDA(item, item.type = 'mammal'))"
        }
      },
      "position": {
        "x": 2655,
        "y": 2460
      },
      "type": "eventTransformation",
      "timeSavedUnit": "minutes",
      "timeSavedValue": 0,
      "monitorAllEvents": false,
      "monitorFailures": false,
      "monitorNoEventsEmitted": null,
      "form": null
    }
  ],
  "links": [
    {
      "sourceIdentifier": 0,
      "receiverIdentifier": 1
    }
  ],
  "diagramNotes": []
}
```