# Lookup Value by Key

Looks up a value by key in a JSON dictionary and returns it as workflow output for use in later incident workflow steps.


> **Availability:** See the [Incident Workflow Actions Overview table](/workflow-actions) for the plans this workflow is available on.

## Description

Lookup a value in a JSON dictionary.

## Instructions

1. If you have not done so, follow the instructions to [Create an Incident Workflow](/ai-automation/automation/incident-workflows#create-an-incident-workflow).
2. When the instructions prompt you to [add actions](/ai-automation/automation/incident-workflows#add-actions), select **this action**.
3. Enter the following **Inputs** and click **Save**.
4. Continue following instructions to **Publish** the Workflow.
5. When the action runs, you will see the **Outputs** listed below.

## Inputs

> **Field References:** Fields with the **\{+\}** icon accept [Field References](/ai-automation/automation/incident-workflows#field-references), which can be useful for referencing incident data or outputs created in prior workflow steps. To add Field References, click **\{+\}**, or enter `{{`, and select relevant fields. Refer to the [Field References](/ai-automation/automation/incident-workflows#field-references) article for more information.

| Name            | Description                                                                                                   |
| :-------------- | :------------------------------------------------------------------------------------------------------------ |
| Key to Lookup   | Enter the key to look up in the JSON dictionary.                                                              |
| JSON Dictionary | Enter the JSON dictionary containing the values to look up, for example, `{"key1":"value1","key2":"value2"}`. |

## Outputs

| Name                        | Description                                                                         |
| :-------------------------- | :---------------------------------------------------------------------------------- |
| Was the Key to Lookup Found | Whether or not the lookup value was found in the dictionary of values.              |
| Lookup Result               | The value associated with the lookup value in the dictionary.                       |
| Result                      | Value that shows if the action was successful or not. Either "Success" or "Failed". |
| Result Summary              | Brief description of what the action did or if it failed.                           |
| Error                       | Brief description that is populated if the action failed.                           |