Welcome to Enigma Docs

Welcome to Enigma! Here you'll find comprehensive guides and documentation to help you start working with Enigma's Businesses product as quickly as possible, as well as support if you get stuck. Let's jump right in!

Get Started    

ID Endpoint

Enigma's ID endpoint supports retrieval of a business profile using its unique Enigma ID.

The ID endpoint supports retrieval of a business profile using its unique Enigma IDEnigma ID - Enigma ID is the unique, persistent ID for the entity in Enigma’s SMB data, assigned as a result of our expert Entity Resolution process.. Additionally, this endpoint allows you to select premium attributes - Enigma’s differentiated, derived attributes that provide key signals about each business entity.

For technical guidance around this endpoint, see our API Reference.

Overview

For example, again suppose an SMB lender is evaluating an application from a business for a loan. The lender is interested in understanding the applicant’s risk profile - things the industry it operates in, what licenses it has, whether it has had any adverse credit events in the past.

Once the lender has identified the applicant using our Match Endpoint, they will use the ID endpoint to retrieve data on the business.

Making a request to businesses/ID

Headers

To make a Businesses API request, first ensure to enter your API key by adding the following request header.

X-api-key: YOUR-API-KEY

Inputs

Once your headers are configured, all you need is the Enigma ID for the business you want to learn more about. The ID endpoint supports GET requests, where the Enigma ID is appended to the Businesses API base URL.

Below is an example of a GET request to pull data on Enigma Technologies using its unique Enigma ID.

Request
import requests
import json

base_url = 'https://api.enigma.com'
headers = {
  'x-api-key': 'YOUR-API-KEY'
}
url = base_url + '/businesses/E000f971c20000020c'
params = {}
response = requests.get(url, params=params, headers=headers).json()
let requesturl = 'lookup/E000f971c20000020c';
// Configure request headers
let headers = new Headers();
headers.append('x-api-key': 'YOUR-API-KEY');
fetch(requesturl, {
  method: 'GET',
  headers: headers
})
.then(response => response.json())
.then(function (response) {
  console.log(response);
})
.catch(function (error) {
  console.log(error);
});
curl -X GET 'https://api.enigma.com/businesses/E000f971c20000020c' -H 'x-api-key: YOUR-API-KEY' | python -m json.tool
Response
{
  "enigma_id": "E000f971c20000020c",
  "data_sources": [
    "Third-Party Active Business",
    "UCC Loans",
    "Corporate Registrations",
    "H1B Visa Applications",
    "Card Transactions"
  ],
  "aliases": [
    "ENIGMA TECHNOLOGIES INC",
    "ENIGMA TECHNOLOGIES INC WA",
    "ENIGMA TECHNOLOGIES"
  ],
  "updated_at": "2021-07-30",
  "addresses": [
    {
      "street_address1": "245 5 AVE",
      "street_address2": "FL 17",
      "city": "NEW YORK",
      "state": "NY",
      "postal_code": "10016"
    },
    {
      "street_address1": "245 5 AVE",
      "street_address2": "",
      "city": "NEW YORK",
      "state": "NY",
      "postal_code": "10016"
    },
    {
      "street_address1": "600 WEST MAIN",
      "street_address2": "",
      "city": "JEFFERSON CITY",
      "state": "MO",
      "postal_code": "65101"
    },
    {
      "street_address1": "245 5 AVE",
      "street_address2": "17 FL",
      "city": "NEW YORK",
      "state": "NY",
      "postal_code": "10016"
    },
    {
      "street_address1": "245 5 AVE 17",
      "street_address2": "",
      "city": "NEW YORK",
      "state": "NY",
      "postal_code": "10016"
    },
    {
      "street_address1": "245 5 AVE",
      "street_address2": "FL 17",
      "city": "NEW YORK",
      "state": "NY",
      "postal_code": ""
    },
    {
      "street_address1": "501 LOUISIANA AVE",
      "street_address2": "",
      "city": "BATON ROUGE",
      "state": "LA",
      "postal_code": "70802"
    },
    {
      "street_address1": "",
      "street_address2": "",
      "city": "NEW YORK",
      "state": "NY",
      "postal_code": ""
    }
  ],
  "ein": [],
  "associated_people": [
    {
      "name": "HICHAM OUDGHIRI",
      "titles": [
        "CEO",
        "OFFICER"
      ]
    },
    {
      "name": "OUDGHIRI HICHAM",
      "titles": [
        "OFFICER"
      ]
    }
  ],
  "registered_agents": [
    "ENIGMA TECHNOLOGIES INC",
    "SECRETARY OF STATE",
    "CORPORATION SERVICE COMPANY D B A CSC-LAWYERS INCORPORATING SERVICE COMPANY",
    "CORPORATION SERVICE COMPANY"
  ],
  "phone_numbers": [],
  "websites": [
    "http://www.enigma.com/"
  ],
  "registrations": [
    {
      "state": "NY",
      "issue_date": "2011-11-09",
      "file_number": "4163621"
    },
    {
      "state": "CA",
      "issue_date": "2018-01-17",
      "file_number": "C4106346"
    },
    {
      "state": "WA",
      "issue_date": "2017-08-20",
      "file_number": "604163534"
    },
    {
      "state": "MO",
      "issue_date": "2018-07-28",
      "file_number": "F001330176"
    },
    {
      "state": "DC",
      "issue_date": "2017-08-18",
      "file_number": "EXTUID_4192167"
    },
    {
      "state": "LA",
      "issue_date": "2016-05-10",
      "file_number": "42261937F"
    },
    {
      "state": "TX",
      "issue_date": "2017-10-27",
      "file_number": "0802847446"
    },
    {
      "state": "HI",
      "issue_date": "2019-01-26",
      "file_number": "100516F1"
    },
    {
      "state": "TN",
      "issue_date": "2019-01-26",
      "file_number": "001007445"
    },
    {
      "state": "MA",
      "issue_date": "2020-04-28",
      "file_number": "001435918"
    }
  ],
  "corporate_structure": "CORPORATION",
  "headcount": null,
  "company_description": [
    "Enigma, a New York-based Data-as-a-Service company, transforms disparate, tabular data into rich representations of real-world relationships, providing a trusted source of intelligence about people, places and companies. From evaluating insurance risk to combating money laundering, Enigma connects and enriches clients’ internal data assets to transform their strategies and workflows. Leading organizations, including American Express, BB&T, EMD Millipore, Celgene and Merck depend on Enigma to power the daily decisions that matter. Enigma was the winner of the TechCrunch Disrupt NY 2013 and a graduate of the 2014 FinTech Innovation Lab. \\\n\\\nWe are hiring, please visit www.enigma.com/careers for more information. \\\n\\\nYou can also follow us on Twitter @enigma_data and visit our Facebook page at https://www.facebook.com/enigma.data.\\\n\\\nAwards:\\\n-Forbes Fintech 50 2018 \\\n-TechCrunch Disrupt NYC 2013 Startup Battlefield Winner \\\n-Dataconnexions Paris 2013 B2B Category Winner\\\n\\\nFor more information please visit the press page on our website."
  ],
  "year_incorporated": "2011"
}

Retrieving premium attributes

📘

To see what the basic profile includes and what premium data is available, see our Attribute Dictionary

Back to our SMB lender example - when evaluating an applicant, the lender may want to know the business’ Verification ScoreVerification Score - The score from 0 to 1 represents Enigma’s confidence, based on the verification components below. and yelp_datayelp_data - A list of Yelp URLs corresponding to Yelp pages associated with the business. To obtain this data, she would configure her attrs param as follows:

attrs: "verification,yelp"

Below is an example of a GET request containing this parameter.

Request
import requests
import json
base_url = 'https://api.enigma.com/businesses/'
headers = {
  'x-api-key': 'YOUR-API-KEY'
}
url = base_url + 'E00003a8000001ea?attrs=yelp,verification'
params = {}
response = requests.get(url, params=params, headers=headers).json()
let requesturl = 'lookup/E00003a8000001ea';
// Configure request headers
let headers = new Headers();
headers.append('x-api-key': 'YOUR-API-KEY');
fetch(requesturl, {
  method: 'GET',
  headers: headers
})
.then(response => response.json())
.then(function (response) {
  console.log(response);
})
.catch(function (error) {
  console.log(error);
});
curl -X GET 'https://api.dev.enigma.com/businesses/E00003a8000001ea?attrs=verification,yelp' -H 'x-api-key: YOUR-API-KEY'| python -m json.tool
Response
{
  "enigma_id": "E00003a8000001ea",
  "data_sources": [
    "Liquor Licenses",
    "Government Assistance",
    "SBA Loans",
    "Third-Party Active Business",
    "UCC Loans",
    "Corporate Registrations",
    "Card Transactions"
  ],
  "aliases": [
    "245 GOURMET FOOD INC",
    "CAFE 28",
    "245 GOURMET FOOD",
    "245 GOURMET FOOD INC DBA 245 GOURMET FOOD INC",
    "245 GOURMENT FOOD INC"
  ],
  "updated_at": "2021-07-30",
  "addresses": [
    {
      "street_address1": "245 5 AVE",
      "street_address2": "",
      "city": "NEW YORK",
      "state": "NY",
      "postal_code": "10016"
    },
    {
      "street_address1": "245 5 AVE",
      "street_address2": "FRNT A",
      "city": "NEW YORK",
      "state": "NY",
      "postal_code": "10016"
    },
    {
      "street_address1": "245 5 AVE",
      "street_address2": "A",
      "city": "NEW YORK",
      "state": "NY",
      "postal_code": "10016"
    },
    {
      "street_address1": "245 5 AVE",
      "street_address2": "RM 1900",
      "city": "NEW YORK",
      "state": "NY",
      "postal_code": "10016"
    },
    {
      "street_address1": "245 5 AVE",
      "street_address2": "",
      "city": "NEW YORK",
      "state": "NY",
      "postal_code": "10001"
    },
    {
      "street_address1": "245 5 AVE",
      "street_address2": "",
      "city": "GROUND FL NEW YORK",
      "state": "NY",
      "postal_code": "10016"
    }
  ],
  "ein": [],
  "associated_people": [
    {
      "name": "EUI CHUN WHANG",
      "titles": [
        "OFFICER"
      ]
    },
    {
      "name": "EUI WHANG",
      "titles": [
        "OWNER"
      ]
    }
  ],
  "registered_agents": [
    "245 GOURMET FOOD INC"
  ],
  "phone_numbers": [
    "+12126867300"
  ],
  "websites": [],
  "registrations": [
    {
      "state": "NY",
      "issue_date": "2003-01-14",
      "file_number": "2856713"
    }
  ],
  "corporate_structure": "CORPORATION",
  "headcount": "1-20",
  "company_description": [],
  "year_incorporated": "2003",
  "verification": {
    "score": 1,
    "components": {
      "data_freshness": 1,
      "source_quality": 1,
      "data_footprint": 1,
      "business_activity": 1
    }
  },
  "yelp": {
    "urls": [
      "https://www.yelp.com/biz/245-gourmet-food-new-york"
    ]
  }
}

📘

Try our API

Try it out in our Quick Start tool or by hitting the API directly.

Updated 3 months ago


ID Endpoint


Enigma's ID endpoint supports retrieval of a business profile using its unique Enigma ID.

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.