# Lookup

{% hint style="info" %}
See the changelog of this Action type [here](https://app.gitbook.com/s/IXj83By4f20oCrZZ0gyP/lookup).
{% endhint %}

## Overview

The **Lookup** action allows you to retrieve information from your uploaded lookups. To learn more about how to upload data, go to [**Enrichment**](https://docs.onum.com/the-workspace/enrichment).

<figure><img src="https://965373739-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkxZeV4nlXcIAjMGZxzLI%2Fuploads%2F5VIHgU2tAJ5eQUb9xrvt%2Flookup%20compressed.gif?alt=media&#x26;token=1b8767a1-dfbe-4cb3-95e1-4308d728a97a" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
In order to configure this action, you must first link it to a Listener. Go to [Building a Pipeline ](https://docs.onum.com/the-workspace/pipelines/building-a-pipeline)to learn how to link.
{% endhint %}

## Ports <a href="#ports" id="ports"></a>

These are the input and output ports of this Action:

<details>

<summary>Input ports</summary>

* **Default port** - All the events to be processed by this Action enter through this port.

</details>

<details>

<summary>Output ports</summary>

* **Default port** - Events are sent through this port if no error occurs while processing them.
* **Error port** - Events are sent through this port if an error occurs while processing them.

</details>

## Configuration

{% stepper %}
{% step %}
Find **Lookup** in the **Actions** tab (under the **Enrichment** group) and drag it onto the canvas. Link it to the required [Listener](https://docs.onum.com/the-workspace/listeners) and [Data sink](https://docs.onum.com/the-workspace/pipelines/data-sinks).
{% endstep %}

{% step %}
To open the configuration, click the Action in the canvas and select **Configuration**.
{% endstep %}

{% step %}
Enter the required parameters:

<table><thead><tr><th width="167">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><strong>Select table</strong><mark style="color:red;"><strong>*</strong></mark></td><td>Select the table you wish to retrieve data from. The tables that show here in the list will be those you previously uploaded in the <strong>Enrichment</strong> view.</td></tr><tr><td><strong>Key columns</strong></td><td>The <strong>Key column</strong> you selected during the upload will automatically appear. Select the field to search for this key column.</td></tr><tr><td><strong>Outputs</strong></td><td>Choose the field that will be injected from the drop-down and assign it a name. Add as many as required.</td></tr></tbody></table>
{% endstep %}

{% step %}
Click **Save** to complete.
{% endstep %}
{% endstepper %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.onum.com/the-workspace/pipelines/actions/enrichment/lookup.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.