---
updatedAt: 2025-08-18T20:11:06.000Z
agentTools:
  projectIndex: https://docs.fullcontact.com/llms.txt
---

# Multi Field Request

# Multi Field Request

With Enrich, the ability to match on one or many input fields is available. Lookup and enrich individuals by sending any identifiers you may already have, such as an email address(es), Twitter handle, Linkedin URL, phone number(s), name and location(address), social URLs, IDs and/or usernames (except Facebook and Instagram), Mobile Advertising IDs (MAIDs) and most recently released as acceptable inputs customer record IDs and person IDs using Resolve API. These identifiers will then be used to locate and return any additional information we may have within the Insights Bundles enabled for your account.

The more contact data inputs you can provide either via API or Batch, the better. By providing more contact inputs, the more accurate and precise we can get with our identity resolution capabilities. If your multi-field request contains incomplete identifier combinations alongside valid inputs, the valid inputs only will be used to identify and enrich an individual. For example, if a name/address combination does not adhere to what is acceptable alongside a valid email, only the valid email will be used to lookup an individual.

> 📘 When providing inputs, there’s a few helpful tips to keep in mind:
>
> * To use MD5 emails, be sure to first lowercase and ensure any extraneous characters (e.g. extra spaces or surrounding quotation marks) are stripped off.
> * When a Hashed Email (HEM), or HEM + other anonymous identifiers like a MAID, is used as input the following PII fields will no longer be returned:
>   * Name
>   * Clear text email, as provided in the Professional bundle
>   * Phone number, as provided in the Professional
>   * Social handles/URLs/IDs
> * To use postal address, a name is required alongside the input and vice versa.
> * Only one name/address combination can be included in the API request
> * To use an international phone number, a country code is required.
> * There is a maximum of 25 identifiers by type that you may use in your multi field request. A 400 Response will be returned if there are more than 25 identifiers for any given identifier type.

```curl
curl -X POST \
  https://api.fullcontact.com/v3/person.enrich \
  -H 'Authorization: Bearer {Your API Key}' \
  -H "Content-Type: application/json" \
  -d '{
  "emails": [
    "bart@fullcontact.com",
    "bart.lorang@fullcontact.com"
  ],
  "phones": [
    "+17202227799",
    "+13035551234"
  ],
  "location": {
    "addressLine1": "123 Main Street",
    "addressLine2": "Unit 2",
    "city": "Denver",
    "region": "Colorado",
    "regionCode": "CO",
    "postalCode": "80203"
  },
  "name": {
    "full": "Bart Lorang",
    "given": "Bart",
    "family": "Lorang"
  },
  "profiles": [{
    "service": "twitter",
    "username": "bartlorang"
    }, {
    "service": "twitter",
    "userid": "5998422"
    }, {
    "service": "linkedin",
    "url": "https://www.linkedin.com/in/bartlorang"
    }, {
    "service": "github",
    "url": "https://www.github.com/lorangb"
    }],
  "maids": ["ape2ch30-pifn-cbvi-30yy-nia-zex7aw5u"],
  "recordId": "customer123",
  "personId": "eYxWc0B-dKRxerTw_uQpxCssM_GyPaLErj0Eu3y2FrU6py1J",
  "li_nonid": "-CmQui5eT6tqBVqQ874WGCv4DNO_taXJOAxVlQ"
  }'
```

<aside class="notice">
  <strong>Location or Name in request</strong>

  <p>
    If you want to use <strong>location</strong> or <strong>name</strong> as an input, both must be present and they must have non-blank values for one of the following field combinations to be eligible for a positive match:
  </p>

  <p>
    <strong>Acceptable minimum combinations for Location</strong>
    <li><code>location.addressLine1</code> + <code>location.city</code> + <code>location.region</code></li>
    <li><code>location.addressLine1</code> + <code>location.city</code> + <code>location.regionCode</code></li>
    <li><code>location.addressLine1</code> + <code>location.postalCode</code></li>
  </p>

  <p>
    <strong>Acceptable minimum combinations for Name</strong>
    <li><code>name.full</code></li>
    <li><code>name.given</code> + <code>name.family</code></li>
  </p>
</aside>

<table class="properties-list">
  <thead>
    <tr>
      <th colspan="2">Input Fields</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        email
        <span class="properties-list-type">string</span>
        <span class="properties-list-type queryable">Queryable</span>
      </td>

      <td>
        One email address of the contact. Can accept cleartext, an MD5 or SHA-256 hash representation of the email address to query. Be certain to lowercase and trim the email address prior to hashing.
      </td>
    </tr>

    <tr>
      <td>
        emails
        <span class="properties-list-type">array</span>
        <span class="properties-list-type queryable">Queryable</span>
      </td>

      <td>
        One or many email addresses of the contact. Can accept cleartext, an MD5 or SHA-256 hash representation of the email address to query. Be certain to lowercase and trim the email address prior to hashing.
      </td>
    </tr>

    <tr>
      <td>
        phone
        <span class="properties-list-type">string</span>
        <span class="properties-list-type queryable">Queryable</span>
      </td>

      <td>
        Phone number of the contact. For international numbers a country code is required.
      </td>
    </tr>

    <tr>
      <td>
        phones
        <span class="properties-list-type">array</span>
        <span class="properties-list-type queryable">Queryable</span>
      </td>

      <td>
        One or many phone numbers of the contact. For international numbers a country code is required.
      </td>
    </tr>

    <tr>
      <td>
        profiles
        <span class="properties-list-type">object</span>
        <span class="properties-list-type queryable">Queryable</span>
      </td>

      <td>
        URLs, IDs and usernames to the profiles on the social platform.
      </td>
    </tr>

    <tr>
      <td>
        name.full
        <span class="properties-list-type">string</span>
        <span class="properties-list-type queryable">Queryable</span>
      </td>

      <td>
        Full name of the contact (givenName, familyName). Only queryable when provided in conjunction with postal address.
      </td>
    </tr>

    <tr>
      <td>
        name.given
        <span class="properties-list-type">string</span>
        <span class="properties-list-type queryable">Queryable</span>
      </td>

      <td>
        The given name (first name) of the individual.  Only queryable when provided in conjunction with postal address.
      </td>
    </tr>

    <tr>
      <td>
        name.family
        <span class="properties-list-type">string</span>
        <span class="properties-list-type queryable">Queryable</span>
      </td>

      <td>
        The family name (last name) of the individual.  Only queryable when provided in conjunction with postal address.
      </td>
    </tr>

    <tr>
      <td>
        location.addressLine1
        <span class="properties-list-type">string</span>
        <span class="properties-list-type queryable">Queryable</span>
      </td>

      <td>
        The first address line for each location. Only queryable when provided in conjunction with name.
      </td>
    </tr>

    <tr>
      <td>
        location.addressLine2
        <span class="properties-list-type">string</span>
        <span class="properties-list-type queryable">Queryable</span>
      </td>

      <td>
        The second address line for each location. Only queryable when provided in conjunction with name.
      </td>
    </tr>

    <tr>
      <td>
        location.city
        <span class="properties-list-type">string</span>
        <span class="properties-list-type queryable">Queryable</span>
      </td>

      <td>
        The city of each location. Only queryable when provided in conjunction with name.
      </td>
    </tr>

    <tr>
      <td>
        location.region
        <span class="properties-list-type">string</span>
        <span class="properties-list-type queryable">Queryable</span>
      </td>

      <td>
        The region of each location. This is often the state or province. Only queryable when provided in conjunction with name.
      </td>
    </tr>

    <tr>
      <td>
        location.regionCode
        <span class="properties-list-type">string</span>
        <span class="properties-list-type queryable">Queryable</span>
      </td>

      <td>
        The region code of each location. Only queryable when provided in conjunction with name.
      </td>
    </tr>

    <tr>
      <td>
        location.postalCode
        <span class="properties-list-type">string</span>
        <span class="properties-list-type queryable">Queryable</span>
      </td>

      <td>
        The postal or ZIP code for each location. Can accept Zip + 4 or Zip. Only queryable when provided in conjunction with name.
      </td>
    </tr>

    <tr>
      <td>
        maids
        <span class="properties-list-type">list</span>
        <span class="properties-list-type queryable">Queryable</span>
      </td>

      <td>
        One or more Mobile Advertising IDs (MAIDs) for an individual.
      </td>
    </tr>

    <tr>
      <td>
        recordId
        <span class="properties-list-type">string</span>
        <span class="properties-list-type queryable">Queryable</span>
      </td>

      <td>
        The client-driven record id attached to a customer.
      </td>
    </tr>

    <tr>
      <td>
        personId
        <span class="properties-list-type">string</span>
        <span class="properties-list-type queryable">Queryable</span>
      </td>

      <td>
        The unique, persistent FullContact person id attached to a customer that is scoped per account.
      </td>
    </tr>

    <tr>
      <td>
        li\_nonid
        <span class="properties-list-type">string</span>
        <span class="properties-list-type queryable">Queryable</span>
      </td>

      <td>
        The LiveIntent pre-authenticated digital nonID.
      </td>
    </tr>
  </tbody>
</table>

# Person Summary Object

When enriching or subscribing to person contacts, Enrich returns a Person Summary object as well as details that include attributes about the person. The details section of the response will be populated based on the [Insights Bundles](person-insights-bundles) that are enabled for the calling account.

> Example Person Summary Object

```json
{
  "fullName": "Bart Lorang",
  "ageRange": "30-39",
  "gender": "Male",
  "location": "Denver, CO, United States",
  "title": "Co-Founder & Managing Director",
  "organization": "V1.vc",
  "twitter": "https://twitter.com/bartlorang",
  "linkedin": "https://www.linkedin.com/in/bartlorang",
  "bio": "CEO & Co-Founder of @FullContact, Managing Director @v1vc_. Tech Entrepreneur, Investor. Husband to @parkerbenson and Father to Greyson Lorang",
  "avatar": "https://d2ojpxxtu63wzl.cloudfront.net/static/a7e6a5aba590d4933e35eaadabd97fd2_44e00e968ac57725a15b32f9ca714827aff8e4818d290cb0c611f2e2585253b3",
  "details": {...}
}
```

<table class="properties-list">
  <thead>
    <tr>
      <th colspan="2">Properties</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        fullName
        <span class="properties-list-type">string</span>
      </td>

      <td>
        Full name of the contact.
      </td>
    </tr>

    <tr>
      <td>
        ageRange
        <span class="properties-list-type">string</span>
      </td>

      <td>
        Age range of the contact.
      </td>
    </tr>

    <tr>
      <td>
        gender
        <span class="properties-list-type">string</span>
      </td>

      <td>
        Gender of the contact.
      </td>
    </tr>

    <tr>
      <td>
        location
        <span class="properties-list-type">string</span>
      </td>

      <td>
        Location of the contact. Depending on data quality, the exactness of this value may vary.
      </td>
    </tr>

    <tr>
      <td>
        title
        <span class="properties-list-type">string</span>
      </td>

      <td>
        Current or most recent job title.
      </td>
    </tr>

    <tr>
      <td>
        organization
        <span class="properties-list-type">string</span>
      </td>

      <td>
        Current or most recent place of work.
      </td>
    </tr>

    <tr>
      <td>
        twitter
        <span class="properties-list-type">string</span>
      </td>

      <td>
        Twitter handle of the contact. Acceptable formats include handle (with or without "@"), as well as the URL to the profile.
      </td>
    </tr>

    <tr>
      <td>
        linkedin
        <span class="properties-list-type">string</span>
      </td>

      <td>
        URL of the contact's LinkedIn profile.
      </td>
    </tr>

    <tr>
      <td>
        bio
        <span class="properties-list-type">string</span>
      </td>

      <td>
        Biography of the contact.
      </td>
    </tr>

    <tr>
      <td>
        avatar
        <span class="properties-list-type">string</span>
      </td>

      <td>
        URL of the contact's photo.
      </td>
    </tr>

    <tr>
      <td>
        details
        <span class="properties-list-type">object</span>
      </td>

      <td>
        When included, additional details about the contact provided through
        [Person Insights Bundles](https://docs.fullcontact.com/docs/person-insights-bundles).
      </td>
    </tr>
  </tbody>
</table>

With the Person Summary object sent in the request, FullContact will attempt to enrich the\
contact with as much information as available, helping to fill in any missing properties, and then returning the Person Summary. The properties that are returned with values during an enrichment are dependent upon the data available for the given contact.