Introduction to Enrich  
========================

#### Enrich your transaction data with merchant, category, and location insights. 

Get started with Enrich

[API Reference](https://plaid.com/docs/api/products/enrich/index.html.md)

#### Overview 

Enrich (US/CA only) makes it easy to work with transaction data generated by your own banking products or retrieved from other non-Plaid sources. Enrich brings context and meaning to your data by enriching it with detailed merchant, category, and location information. The enriched data can be used to build apps and features that help users manage their cash flow, earn rewards, and discover other financial products to help them reach their financial goals.

[Prefer to learn by watching? Get an overview of how Enrich works in just 3 minutes!](https://www.youtube.com/watch?v=2-iJtjzE_6U)

#### Sample Enrich data 

Below is an example of the enrichments Plaid can provide for a transaction.

Sample transaction:

```text
PURCHASE WM SUPERCENTER #1700 POWAY CAUS
```

Enrichments returned by Plaid:

```json
{
  "counterparties": [{
    "name": "Walmart",
    "type": "merchant",
    "logo_url": "https://plaid-merchant-logos.plaid.com/walmart_1100.png",
    "website": "walmart.com",
    "entity_id": "O5W5j4dN9OR3E6ypQmjdkWZZRoXEzVMz2ByWM"
  }],
  "entity_id": "O5W5j4dN9OR3E6ypQmjdkWZZRoXEzVMz2ByWM",
  "location": {
    "address": "13425 Community Rd",
    "city": "Poway",
    "region": "CA",
    "country": "US",
    "postal_code": "92064",
    "store_number": "1700",
    "lat": 32.959068,
    "lon": -117.037666
  },
  "logo_url": "https://plaid-merchant-logos.plaid.com/walmart_1100.png",
  "merchant_name": "Walmart",
  "payment_channel": "in store",
  "personal_finance_category": {
    "detailed": "GENERAL_MERCHANDISE_SUPERSTORES",
    "primary": "GENERAL_MERCHANDISE"
  },
  "personal_finance_category_icon_url": "https://plaid-category-icons.plaid.com/PFC_GENERAL_MERCHANDISE.png",
  "website": "walmart.com"
}
```

#### Testing Enrich 

Enrich is available for use in all environments.

Sandbox: Test the integration with sample transaction data. Send a request with data from this [preset list](https://plaid.com/documents/enrich_sandbox_preset_transactions.csv) of sample transactions to receive a response.

Production: Get real enrichments for all your transactions.

*   If you don't yet have a Plaid plan, or are on a Pay-as-you-go or Growth plan, you can get access to Enrich by submitting a [Production request](https://dashboard.plaid.com/onboarding/) .
*   Existing Custom plan customers can self-enable for Enrich by agreeing to the terms of service in the [Dashboard](https://dashboard.plaid.com/settings/platform/enrich) .

When testing Enrich in Production, make sure to use input data and amounts that are as realistic as possible, as all input fields, not just `description`, are used to analyze transactions.

For more details and best practices on testing Enrich, see the [Enrich Testing Guide](https://docs.google.com/document/d/1i4MNohhIYQ5lG-Qn7BC7O5DwO47tcG-Yy1rHoZcVmx8/edit?tab=t.0#heading=h.yiyk3gvjtv90) .

#### Enrich integration process 

1.  Prepare your transaction data for enrichment. Plaid accepts a maximum of 100 transactions per request. For each transaction, include the `description`, `amount`, `direction`, `iso_currency_code` and `id`. For the best results, provide values in the optional `location`, `mcc`, and/or `date_posted` fields, if available.
2.  Call [/transactions/enrich](https://plaid.com/docs/api/products/enrich/index.html.md#transactionsenrich) to send Plaid your transactions.
3.  Plaid will provide an API response with all available enrichments for the transactions.

#### Enrich pricing 

Enrich is billed on a [flexible fee model](https://plaid.com/docs/account/billing/index.html.md#per-request-flexible-fee) ; you will be billed based on the number of transactions sent for enrichment. To view the exact pricing you may be eligible for, [apply for Production access](https://dashboard.plaid.com/overview/production) or [contact sales](https://plaid.com/contact/) . For more details about pricing and billing models, see [Plaid billing](https://plaid.com/docs/account/billing/index.html.md) .