Batch Upload

The Batch Upload feature provides access to Enigma's SMB data without hitting the API directly. This tool is a great way for new users to evaluate our data prior to building an integration, or for non-technical users to pull SMB data on an ongoing basis. The uploader can be accessed via the Console, on the Batch Upload page.


Let's go back to our example of a lender with an SMB loan portfolio. The lender may want to periodically check the portfolio for signals of distress - bankruptcies and business closures, for example. The lender can upload a CSV containing the list of businesses using our CSV Uploader tool and specify the attributes she wants returned. The tool will then populate these attributes for the list of businesses provided and output a CSV containing the results.

Using the CSV Uploader

To begin, prepare a CSV file containing the following headers:

  • business_name
  • street_address1
  • street_address2
  • city
  • state
  • postal_code
  • first_name
  • last_name
    Feel free to use our sample file, which has correctly formatted headers prepared for you.

Then, populate these inputs for the businesses whose data you want to retrieve.

Once the file is ready, navigate to the Batch Upload tool in the Enigma Console and follow the instructions on the page. Drag and drop your CSV file directly into the modal. Then, select the relevant query parameters. From there, choose your desired premium attributes (if you want basic attributes only, click "Skip and Submit"). Finally, hit "Submit Batch" when ready.

When a job is in progress, its status will be shown as "Pending" in the Batch Activity tab within the Batch Upload page. Once the job is complete, you will receive an email containing a link to your output file. Alternatively, you can find it directly in the "Batch Activity" tab and download the result from there.

Later, you can also use the Batch Activity tab to track your batch upload history. You'll be able to see the name of the file you uploaded, when it was submitted, how many businesses it contained, and which premium attributes were requested, and which query parameters were used.

Happy batching!