Getting Started with Enrich

The Enrich API provides additional data points to customer and prospect data in the form of Insight Bundles. You can find more about the Enrich API under Enrich Overview on the left navigation bar but now that we have our API Key, let's jump into a simple Enrich call!

The Enrich API uses a RPC-style interface. All requests sent to the API are done over HTTPS using the POST method, with content sent as JSON in the request body. All acceptable inputs and combinations are highlighted in the Multi Field Request section of the API documentation. For this simple example we will call the enrich API with a single email identifier.

Step 1: If you already have an account, start by logging in. If you don’t have an account, start by creating one in the FullContact Platform.

Doing so will allow you to access the FullContact Platform, which has some helpful tools to get started interacting with FullContact’s services, which you can read more about in the FullContact Platform Overview. Additionally, having an account will allow you to generate an API Key, which is required to interact with our APIs.

Navigate to the “API Keys” menu and click “GENERATE NEW API KEY”. Follow the prompt, giving your API key a name.

Note: Copy your API key and store it somewhere secure. You will not be able to see the whole key again. No longer have access to the full key? Don’t worry! You can generate a new one using the same process.

Be sure to keep this key secure and only share through secure and appropriate channels when necessary. If someone gains access to your API key, they will be able to incur unwanted charges against your account. You can delete keys at any time should you accidentally expose them to the world.

Step 2: Now that you have generated your API key, let’s enrich a person via the API. In this step, we will be sending data to the FullContact in the form of a multi field identifier.

curl --request POST 'https://api.fullcontact.com/v3/person.enrich' \
    -H 'Authorization: Bearer FC_API_KEY' \
    -H 'Content-Type: application/json' \
    -d '{
        "email": "[email protected]"
    }'
{
    "fullName": "Shawn D Riedel",
    "ageRange": "29-39",
    "gender": "Male",
    "location": "Lexington, Kentucky, United States",
    "title": "Swimming Specialist",
    "organization": "American Power Locks",
    "twitter": "https://twitter.com/riddlesontime",
    "bio": "Swimming specialist at American Power locks",
    "avatar": "https://img.fullcontact.com/sandbox/18x3-Mrv8IyENsOVKg4ui4HZnGiZYReEh.png",
    "website": "http://www.shawnpower.com/",
    "details": { ... }
}

Step 3: Next Steps with Enrich

Jump into the Enrich a Person API call to see examples on how to call Enrich, or check out one of our libraries below.

Client Libraries

Client Libraries have been written for FullContact’s Enrich, Resolve & Verify APIs in GO, Java 8, Java 11+ and Python.

Customers can streamline the use of our Enrich, Resolve & Verify APIs by utilizing basic parts of our code, reducing the amount of code needed to write and enable within your products and solutions in order to effectively and efficiently utilise each API.

Our libraries are available in the following languages:

Data Dictionary

A Data Dictionary is a collection of names,definitions,volumes/coverage,attributes about data elements and its examples that are being used or captured in a database, information system. It describes the meanings and purposes of data elements and provides guidance on interpretation, accepted meanings and representation.

Download FullContact Data Dictionary here

📘

Prefer to batch enrich your data? Reach out to a sales representative to learn more.