Getting Started: Multi-Field Request

Getting Started: Multi-Field Request

What is Multi-Field Request?


Multi-Field Request is a feature enhancement to our Enrich API launched on July 1st, 2019. It adds the ability to match multiple input fields that may be available instead of just one. Using multi-field requests, you can submit any contact identifiers you already have for a given individual:

  1. Personal/work email address (hashed or clear text)
  2. Phone number(s)
  3. Mobile Ad IDs
  4. Social ID
  5. Social URL
  6. Social username 
  7. Record IDs
  8. PersonIDs
  9. Name and home address (must have both and not available on the trial plan)

These identifiers will be used to resolve to an individual and return additional information through Insights Bundles enabled for your account. 

Why Multi-Field?

  • Noticeable increase in Match Rates

  • Ability to query based on new & combination identifiers like name & address

  • More secure authorization

Who has access to Multi-Field Request?

All users of Enrich API will have access to Multi-Field Enrich. However, users of our v2 API will not have access to the multi-field request. We recommend that you upgrade to Enrich API to access this powerful capability.  

How to use Multi-Field Request?

Multi-field request capability will be available on the existing Enrich API endpoint and there is no need to generate a new key. However, you will need to change the way input is passed to the API. 

So, what’s changed for the input fields?

  1. You will now be able to search on one or many email addresses and phone numbers for a given contact.

  2. Email Hash is now part of the email input field instead of its own input field.

  3. You will now be able to search on social IDs, URLs, and usernames (except Facebook and Instagram).

  4. You can now search on location or name in the request, if both are present and follow the laid combination it enhances call out.

Detailed information about input fields is available in our Developer Docs.

    • Related Articles

    • Getting Started: Identity Streme

      FullContact Identity Streme is a flexible and encrypted private environment that ingests, obfuscates, and stores data (so you don’t have to). Identity Streme receives fragmented customer identities and utilizes the Identity Graph to map them to a ...
    • Getting Started: Match Test in Platform

      Platform Match Test Preview Your Expected Match Rate Before Purchasing. The ability to see how FullContact’s data can enrich and enhance your data is a vital first step in a partnership. Our Match Test Tool on our Platform is a seamless way to see ...
    • Getting Started: Verify

      With Verify, you can identify actual individuals and assess risk in real-time using matches, signals, and activity scores from our identity graph. Verify Match: We compare the data in our identity graph with your data on a specific person to offer a ...
    • Getting Started: Permission API

      FullContact's Permission API helps partners, agencies and brands monitor a range of permissions and preference activities over time and obtain information about an individual's consent, which includes: Acknowledgment and purpose of consented data ...
    • Getting Started: Data Delivery

      API & Batch There are two methods of delivering data to FullContact: batch or real-time API. Real-time API Client sets up API integration with FullContact so that data can be delivered in real time into the application of their choice (e.g. CRM, ...