Enigma Docs

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    

Attribute Dictionary

Intro to SMB Attributes

This page defines the list of attributes available in the Businesses API. For each attribute, we denote the output values and how to interpret them.

Basic Attributes

Match Details

Price: Free

Attribute Code

Description

match_confidence

Indicates the extent to which the user’s query matched a business record in Enigma’s SMB data asset, where 1 represents an exact match. (Number from 0 to 1)

matched_fields

Shows the name, address, and person in Enigma’s data asset, that were found in relation to the user’s query

is_matched

Whether the match_confidence for the returned business exceeds the match threshold. To return non_matches, set show_non_matches: 1 in your Request parameters

JSON Sample
{
    "match_confidence": 0.97,
    "matched_fields": {
        "name": "ENIGMA TECHNOLOGIES INC",
        "address": {
            "street_address1": "245 5 AVE", 
            "street_address2": "FL 17",
            "city": "NEW YORK",
            "state": "NY",
            "postal_code": "10016" 
        },
        "person": "HICHAM OUDGHIRI"
    },
    "is_matched": true
}

Business Identifiers

Price: Free

Attribute Code

Description

enigma_id

Enigma's unique identifier for the business

aliases

The various names for the business found in Enigma’s data sources, ordered by prevalence

addresses

List of addresses for the business containing street, city, state, and postal code

ein

The EIN numbers associated with the business

phone_numbers

The phone numbers associated with the business

year_incorporated

Year of the earliest incorporation date found in Enigma’s data sources

websites

List of website URLs associated with the business

company_description

Description of the business and its main activities

JSON Sample
{
    "aliases": [
        "ENIGMA TECHNOLOGIES INC"
    ],
    "ein": [
        "12-3456789"
    ],
    "year_incorporated": "2011",
    "websites": [
        "https://www.enigma.com/"
    ],
    "company_description": [
        "Search reliable data on every small business"
    ]
}

Firmographics

Price: Free

Attribute Code

Description

associated_people

People associated with the business and their titles

registered_agents

A registered agent is a business or individual designated to receive service of process when a business is involved in a legal matter

corporate_structure

The legal structure under which the business is incorporated

headcount

Estimated headcount for the business based on available sources

JSON Sample
{
    "associated_people": [
        {
            "name": "HICHAM OUDGHIRI",
            "titles": [
                "OFFICER"
            ]
        }
    ],
    "registered_agents": [
        "ENIGMA TECHNOLOGIES INC",
        "CORPORATION SERVICE COMPANY"
    ],
    "corporate_structure": "CORPORATION",
    "headcount": "100-500"
}

Registrations

Price: Free

Attribute Code

Description

registrations

A list of states and corresponding registration dates for state-level corporate registrations found in Enigma’s data sources

JSON Sample
{
    "registrations": [
        {
            "state": "NY",
            "issue_date": "2011-11-09",
            "file_number": "4163621"
        }
    ]
}

Premium Attributes

We model our premium attributes from hundreds of private and public sources to provide unique signals about a business.
Premium attributes can be retrieved through the ID endpoint by selecting codes for desired premium attributes with the attrs query parameter. For example, to select premiums attributes with codes abc and def, append the query parameters ?attrs=abc,def to the end of the URL for the ID endpoint. See Quick Start for more details.

Verification

Price: $0.563

Attribute Code

Description

verification

The score from 0 to 1 represents Enigma’s confidence, based on the verification components below.

JSON Sample
{
  "verification": {
      "score": 0.86,
      "components": {
          "data_freshness": 1.0,
          "source_quality": 1.0,
          "data_footprint": 0.53,
          "business_activity": 1.0
      }
  }
}

Business Bankruptcy

Price: $0.24
Charge for null values: Yes

Attribute Code

Description

business_bankruptcy

Whether the business has filed for bankruptcy and a list of the bankruptcy filings’ chapter type, filing date, and case number

JSON Sample
{
 "business_bankruptcy": {
            "bankruptcy_flag": true, 
            "bankruptcy_records": [
            {
                "chapter_type": "11",
                "filing_date": "2020-03-15",
                "case_number": "2:13-bk-39635"
            },
            {
                "chapter_type": "7",
                "filing_date": "2020-04-19",
                "case_number": "2:14-bk-17090"
             }
        ]
    }
}

OSHA Inspections & Violations

Price: $0.03
Charge for null values: Yes

Attribute Code

Description

osha

The number of OSHA inspections and violations a business has had in its lifetime; which standards it has violated, and any penalties associated with violations.

JSON Sample
{
    "osha": {
        "total_inspections": 1,
        "total_violations": 2,
        "violations_inspections_ratio": 2.0,
        "months_since_inspection": 528,
        "months_since_violation": 531,
        "violation_details": [
            {
                "standard_violated": "19260250 B01",
                "record_type": null,
                "hazard_category": null,
                "current_penalty": null,
                "issuance_date": "7889-05-10"
            },
            {
                "standard_violated": "19260500 D01",
                "record_type": null,
                "hazard_category": null,
                "current_penalty": 70.0,
                "issuance_date": "7889-05-10"
            }
        ]
    }
}

Firearms Licenses

Price: $0.03
Charge for null values: Yes

Attribute Code

Description

firearms_licenses

The year issued, type, and expiration date for on any licenses a business has that authorize it to sell firearms

JSON Sample
{
    "firearms_licenses": [
        {
           "type_description": "Pawnbroker in Firearms Other Than Destructive Devices",
           "issued_year": "2018",
           "expiration_date": "2021-02-01"
        }
    ]
}

Yelp Presence

Price: $0.015
Charge for null values: Yes

Attribute Code

Description

yelp

A list of Yelp URLs corresponding to Yelp pages associated with the business

JSON Sample
{
   "yelp":{
      "urls":[
         "https://www.yelp.com/biz/nourish-brooklyn-4"
      ]
   }
}

SBA Loans

Price: $0.03
Charge for null values: Yes

Attribute Code

Description

sba_loans

The overall number, value, and status of loans the businesses has received from the SBA, as well as individual loan details.

{
    "sba_loans": {
        "total_number": 5,
        "total_value": 1200000.5,
        "total_number_active": 1,
        "total_value_active": 200000.5,
        "total_number_charged_off": 0,
        "total_value_charged_off": 0.0,
        "loan_details": [
            {
                "approval_date": "2017-10-01",
                "loan_status": "PIF",
                "gross_approval_amount": 25000.5,
                "term_months": 120,
                "loan_type": "7a"
            }
        ]
    }
}

Construction Contractor Licenses

States: AZ, CA, FL, MD, NC, OH, OR, PA, SC, TX, WA
Price: $0.72
Charge for null values: Yes

Attribute Code

Description

construction_contractor_licenses

The contractor licenses held by the business in different states, including license types, status, and expiration dates

JSON Sample
{
    "construction_contractor_licenses": {
        "CA": { 
            "has_license_history": true,
            "licenses" : [
                {
                    "license_number": "78210512",
                    "start_date": "2017-01-01",
                    "end_date": "2022-12-31", 
                    "classification": "Cementing",
                    "details": { 
                        "issue_date": "2012-01-01",
                        "reissue_date": "2016-01-01",
                        "effective_date": "2017-01-01",
                        "expiration_date": "2022-12-31",
                        "license_number": "78210512",
                        "primary_status": "Commercial",
                        "license_type": "Cementing"
                    }
                }
            ]
        },
        "FL": {
            "has_license_history": false,
            "licenses" : []
        },
        "MD": {
            "has_license_history": false,
            "licenses" : []
        },
        "NC": {
            "has_license_history": false,
            "licenses" : []
        },
        ... // additional states
    }
}

Government Contracts

Price: $0.06
Charge for null values: Yes

government_contracts

Whenever a city, state, or Federal government agency contracts a private company to do some work, they must log this in a publicly available contract. These contracts indicate stable, pre-committed revenue, a very positive signal for a company.

• The aggregate number, value, & locations of all government contracts the business has been awarded.
• The amount, locale, and date details of each contract.

JSON Sample
{
    "government_contracts": {
        "aggregate": [
            {
                "year": "2018", 
                "locations": ["FL"],
                "total_number": 1,
                "total_value": 1000000.0
            },
            {
                "year": "2020",
                "locations": ["USA", "New York, NY"],
                "total_number": 2,
                "total_value": 7950000.0
            }
        ],
        "details": [
            {
                "location": "FL",
                "agency_name": "Health Manufcaturing",
                "amount": 1000000.0, 
                "description": "COVID-19 Ventilator production.",
                "start_date": "2018-08-01",
                "end_date": "2021-07-31"
            },
            {
                "location": "USA",
                "agency_name": "Public Safety",
                "amount": 7300000.0,
                "description": "N-95 Masks.",
                "start_date": "2020-01-01"
            },
            {
                "location": "New York, NY",
                "agency_name": "Health Goods",
                "amount": 650000.0,
                "description": "N-95 Masks.",
                "start_date": "2020-02-01"
            }
        ]
    }
}

Import Data (Beta)

Price: $0.09
Charge for null values: No

Attribute Code

Description

imports_beta

A list where each entry is a country name, a time period (week of the year), and the number of shipments imported by the business in the last year, broken out by country of origin and week of the year.

JSON Sample
{
    "imports": [
        {
            "country_name": "China (Mainland)",
            "period": "2019W01",
            "quantity": 5
        },
        {
            "country_name": "China (Mainland)",
            "period": "2019W22",
            "quantity": 2
        },
        {
            "country_name": "China (Mainland)",
            "period": "2020W10",
            "quantity": 3
        },
        {
            "country_name": "All",
            "period": "2019",
            "quantity": 56
        }
    ]
}

Industry Classification (Beta)

Price: $0.24
Charge for null values: No

Attribute Code

Description

industry_beta

A list of the predicted industries of this company according to Enigma’s industry taxonomy, as well as mappings to common industry classification systems for integration purposes.

JSON Sample
{
    "industry_beta": [
        {
            "enigma_industry": "Construction and Engineering",
            "sector": "Industrials",
            "industry_group": "Capital Goods",
            "industry": "Construction and Engineering",
            "sub_industry": "Construction and Engineering",
            "naics_code": 23,
            "gics_code": 20103010
        },
        {
            "enigma_industry": "Construction Materials",
            "sector": "Materials",
            "industry_group": "Materials",
            "industry": "Construction Materials",
            "sub_industry": null,
            "naics_code": 23,
            "gics_code": 15102010
        }
    ]
}

WARN Act Notifications (Beta)

States: NY, VA, FL
Price: $0.19
Charge for null values: No

Attribute Code

Description

warn_act_notifications_beta

One entry per WARN notification containing details on the number of employees and date of layoff.

The Worker Adjustment and Retraining Notification (WARN) Act of 1988 is a federal law that requires companies that employ more than 100 employees to give 60-day advance notice if they intend to lay off more than 50 employees at a single site. Thus, this is a leading indicator of business health and headcount.

JSON Sample
{
    "warn_act_notifications": [
        {
            "layoff_or_closing": "layoff", 
            "notice_received_date": "2019-03-20", 
            "employees_impacted": 52, 
            "total_employees": 100,
            "percentage_impacted": 0.52,
            "layoff_or_closing_date": "2019-03-19", 
            "reason": "Unforeseeable business circumstances prompted by COVID-19" 
        }
    ]
}

Business Closures / Operating Status (Beta)

Price: $0.34
Charge for null values: No

Attribute Code

Description

operating_status_beta

Business closures as reported across web sources including Yelp, Eater, the business’s website, and a government sources. Closures are marked with status = closed. A null status indicates the business is open.

JSON Sample
{
    "operating_status": {
        "status": "CLOSED",
        "confidence_score": 0.85,
        "last_updated": "2020-03-20"
    }
}

Corporate Registration Details

Price: $0.56
Charge for null values: No

Attribute Code

Description

corporate_registration_details

List of a company's corporate registrations, with full details

{
    "corporate_registration_details": [
        {
            "business_name": "ENIGMA TECHNOLOGIES, INC.",
            "is_domestic": "foreign",
            "mailing_address": "245 5TH AVENUE, 17TH FLOOR, NEW YORK, NEW YORK, 10016, UNITED STATES",
            "registered_agent_address": "245 5TH AVENUE, 17TH FLOOR, NEW YORK, NY, 10016",
            "registered_business_address": "245 5TH AVENUE, 17TH FLOOR, NEW YORK, NEW YORK, 10016, UNITED STATES",
            "site_address": "ENIGMA TECHNOLOGIES, INC., 245 5TH AVENUE, 17TH FLOOR,NEW YORK,NEW YORK,10016",
            "state_jurisdiction": "DE"
        }
    ]
}

Premium Attributes Pricing

Our pay-as-you-go pricing is simple and flexible.

Pricing is based on your choice of premium data attributes and the number of API calls you make. You can find the price of each premium attribute in the table above.

We only charge you for API calls that return premium attributes - if we don't have any premium attributes for a business, you won't be charged for that call. Match calls are always free and we won't charge you for any basic attributes returned in an Enigma ID call.