---
updatedAt: 2026-08-26T20:16:32.000Z
agentTools:
  projectIndex: https://cloud.docs.tamr.com/llms.txt
---

# Moody's Enrichment

<Callout icon="👋" theme="default">
  ### Looking to use Moody's Enrichment?

  Moody's enrichment is supported in limited release [RealTime data products.](https://cloud.docs.tamr.com/tamr-cloud/docs/realtime-data-product-experience)

  Contact Tamr at [help@tamr.com](mailto:help@tamr.com) to inquire about licensing options and configuration assistance.
</Callout>

You can enrich your global company records with firmographic data from <Anchor target="_blank" href="https://www.moodys.com/web/en/us/capabilities/company-reference-data/orbis.html">Moody's Orbis</Anchor>, through the Moody's Orbis Match API.

# Requirements for Moody's Enrichment

In order to use Moody's enrichment:

1. You must have obtained a license and API key for Moody's Orbis Match API through Moody's. Add your Moody's Orbis Match API key on the Admin > API Keys page.  See [Managing API Keys](https://cloud.docs.tamr.com/tamr-cloud/docs/managing-api-keys).
2. You must be entitled to use Moody's enrichment in the product.  Contact Tamr at <help@tamr.com> to set this entitlement and for configuration assistance.

# Matching Company Records to Moody's Enrichment

Tamr submits the following attributes to the Moody's Orbis Match API to match your records for enrichment:

* Company name
* Primary address values
* Website
* National ID
* Primary Phone
* Ticker

# Enrichment Attributes Provided by Moody's Orbis

Tamr enriches your company records with these attributes from Moody's Orbis for matches above a specified match score (set by Tamr as part of Moody's configuration):

<Table>
  <thead>
    <tr>
      <th>
        Moody's Attribute
      </th>

      <th>
        Description
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        moodys_match_score
      </td>

      <td>
        Match accuracy as a percentage
      </td>
    </tr>

    <tr>
      <td>
        moodys_match_hint
      </td>

      <td>
        Match confidence:

        - Selected: high confidence, best candidate
        - Potential: medium confidence, good candidate
        - Unlikely: low confidence, not a good candidate
      </td>
    </tr>

    <tr>
      <td>
        moodys_match_name
      </td>

      <td>
        Primary name of the company (canonical name)
      </td>
    </tr>

    <tr>
      <td>
        moodys_match_name_local
      </td>

      <td>
        Company name in local alphabet
      </td>
    </tr>

    <tr>
      <td>
        moodys_match_matched_name
      </td>

      <td>
        The specific company name variation that caused this record to match, such as trade name, previous name, and so on.
      </td>
    </tr>

    <tr>
      <td>
        moodys_match_matched_name_type
      </td>

      <td>
        Type of the moodys_match_matched_name
      </td>
    </tr>

    <tr>
      <td>
        moodys_match_address
      </td>

      <td>
        Company street address
      </td>
    </tr>

    <tr>
      <td>
        moodys_match_city
      </td>

      <td>
        Company city
      </td>
    </tr>

    <tr>
      <td>
        moodys_match_state
      </td>

      <td>
        Company state (for US and CA)
      </td>
    </tr>

    <tr>
      <td>
        moodys_match_region
      </td>

      <td>
        Company region&#x20;
      </td>
    </tr>

    <tr>
      <td>
        moodys_match_postcode
      </td>

      <td>
        Company postal code
      </td>
    </tr>

    <tr>
      <td>
        moodys_match_country
      </td>

      <td>
        Company country
      </td>
    </tr>

    <tr>
      <td>
        moodys_match_address_type
      </td>

      <td>
        Company address type, such as registered address, priority address, legal address, and so on.
      </td>
    </tr>

    <tr>
      <td>
        moodys_match_phone_or_fax
      </td>

      <td>
        Company phone or fax number
      </td>
    </tr>

    <tr>
      <td>
        moodys_match_email_or_website
      </td>

      <td>
        Company email or website
      </td>
    </tr>

    <tr>
      <td>
        moodys_match_national_id
      </td>

      <td>
        Company national identifier, such as VAT numbers or registration numbers, or international identifiers such as LEIs.
      </td>
    </tr>

    <tr>
      <td>
        moodys_match_national_id_label
      </td>

      <td>
        Label associated with the moodys_match_national_id  (national ID type)
      </td>
    </tr>

    <tr>
      <td>
        moodys_match_legal_form
      </td>

      <td>
        Company legal form
      </td>
    </tr>

    <tr>
      <td>
        moodys_match_consolidation_code
      </td>

      <td>
        Orbis financial statement consolidation code<br /><br />**Note:** This is not related to Tamr record consolidation
      </td>
    </tr>

    <tr>
      <td>
        moodys_match_status
      </td>

      <td>
        Company status, such as active, dissolved, and so on.
      </td>
    </tr>

    <tr>
      <td>
        moodys_match_ticker
      </td>

      <td>
        Company ticker
      </td>
    </tr>

    <tr>
      <td>
        moodys_match_custom_rule
      </td>

      <td>
        Not currently used; returns empty
      </td>
    </tr>

    <tr>
      <td>
        moodys_match_isin
      </td>

      <td>
        International securities identification number
      </td>
    </tr>

    <tr>
      <td>
        moodys_match_bvd_id
      </td>

      <td>
        Unique Moody's Orbis company identifier
      </td>
    </tr>

    <tr>
      <td>
        moodys_match_success
      </td>

      <td>
        Whether the API call was successful  (true/false)
      </td>
    </tr>
  </tbody>
</Table>

#

<br />

<br />