Designing An Integration

Now that you’ve created an account and configured your organization, it’s time to design an integration. Our goal at Enigma is to make it as easy as possible for you to integrate our SMB data into your business processes. This guide provides a step-by-step process to help you make the most of our data by designing the right integration for your needs.


Step 1: Your Use Case and Business Process

The first step is to determine which Enigma data attributes would be valuable to integrate into your business processes (for some background on typical use cases for Enigma’s SMB data, click on the Use Cases links at the bottom of the navigation bar).

We provide a wealth of business data that can enhance processes as simple as verifying an SMB applicant or as complex as feeding inputs into a proprietary risk model.

For example, a typical SMB lender may want to:

  • Use Enigma’s growth and resiliency signals (see the Attribute Dictionary) to evaluate a new loan application
  • Leverage Enigma’s distress signals to monitor an SMB borrower over time and adequately account for risk when providing additional credit.
  • Depending on your use case and business process, you’ll find different combinations of SMB attributes useful. It’s helpful to identify these upfront as they can inform your integration approach.

Step 2: Point of integration

The next step is to figure out the right integration point. In other words, at what stage and frequency will you require the SMB attributes you identified in step 1? For example, you may need to pull the data in real-time, when onboarding new SMBs onto your platform. Or you may retrieve it for periodic health checks on your SMB portfolio.

Below are some possible points of integration to consider:

  • Real-time

    As part of a signup or application flow

  • Monitoring

    Periodic checks on individual SMBs in your portfolio

  • Batch

    Enriching your SMB records in bulk

  • Ad hoc

    Adding Enigma’s data to your existing SMB records as needed

Step 3: Method of integration

Now that you’ve determined what data you need and the right point to integrate it, it’s time to choose the best method of integration.

Our Businesses API underpins all of our SMB data delivery. For technical users and/or real-time integrations, we recommend hitting our API directly. More advanced users may also want to build internal services on top of our API - this is a great way to overlay additional logic on top of our API results in a manner customized to your business processes.

If you're not technically inclined or don't want to set up an API integration, no worries! You can use our Batch Upload tool to upload a CSV of businesses, select the data you want and then download the results when ready.

Step 4: Gathering inputs

At this point, we’ve figured out the framework for our integration. Now it’s time to set it up! This will require gathering the right inputs for the SMB profiles you wish to retrieve.

Currently, any time you ping Enigma for information about a business, we require at least 2 of the following 3 input fields:

  • Business Name
  • Address
  • Associated person

Before beginning your integration work, be sure to compile this information for each SMB. And note that the more information collected in your input (within the 3 input fields), the higher the coverage your integration will achieve.

Step 5: Matching

Once you have your data inputs, you can begin hitting our Businesses API for results. This is a two-step process that - for each business input - involves first finding a match in Enigma’s SMB data records, and subsequently pulling relevant data for enrichment.

The matching step helps you determine whether Enigma has a business record that corresponds to your input. This ensures that prior to integrating any of our SMB attributes, you are certain that the business record you are pulling is the correct one.

Matching is performed by hitting the Match Endpoint of our Businesses API (for more information, visit the Match Endpoint page). For each Match request, be sure to store the unique Enigma ID for the business returned in the response.

Step 6: Data enrichment

For each record, once you’ve performed a Match request and identified the corresponding business in Enigma’s records, you can be confident in retrieving Enigma’s attributes for the business.

To do so, use the Enigma ID retrieved in step 5 to hit the ID Endpoint of our Businesses API (for more information, visit the ID Endpoint page). The ID endpoint allows you to obtain our premium attributes in addition to the basic profile for each SMB.

QA and Go-Live

That’s it, you’ve completed your integration design. Be sure to QA your integration and then you're ready to go live! Continue reading our documentation to learn more about each step in the process.

Did this page help you?