# Get Record from Record Map

Retrieve a particular record from a [RecordMap](https://docs.gradient.works/kb/automation-builder-kit-abk/models/recordmap) using the specified key. This will commonly be used inside a Flow loop to efficiently retrieve a related record.

For example, consider the following Flow structure:

1. Use `Get Records` to retrieve a collection of Contacts
2. Use [Build Record Map from Lookup](https://docs.gradient.works/kb/automation-builder-kit-abk/actions/advanced/gwfxbuildrecordmapfromlookupaction) to get a [RecordMap](https://docs.gradient.works/kb/automation-builder-kit-abk/models/recordmap) of related Accounts using their `Id` as the key
3. Use a `Loop` over the collection of Contacts
4. Use [Get Record from Record Map](https://docs.gradient.works/kb/automation-builder-kit-abk/actions/advanced/gwfxrecordmapgetaction) inside the loop with `Contact.AccountId` as the key to get the related Account

This approach ensures that your Flow will run efficiently within the [Salesforce Flow limits](https://help.salesforce.com/articleView?id=sf.flow_considerations.htm\&type=5) by reducing queries and CPU time.

## Inputs

| Name      | Required | Type                                                                                    | Description                                                                                                                             |
| --------- | -------- | --------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| key       | Yes      | String                                                                                  | The key (usually an Id) to use for looking up a particular record                                                                       |
| recordMap | Yes      | [RecordMap](https://docs.gradient.works/kb/automation-builder-kit-abk/models/recordmap) | The [RecordMap](https://docs.gradient.works/kb/automation-builder-kit-abk/models/recordmap) from a previous action to use for retrieval |

## Outputs

| Name   | Type    | Description                                                                                                  |
| ------ | ------- | ------------------------------------------------------------------------------------------------------------ |
| record | SObject | The record retrieved based on the key. This may be null if there is no record assigned to the specified key. |