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!
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.
Attribute Code | Description |
|---|---|
| Indicates the extent to which the user’s query matched a business record in Enigma’s SMB data asset, where |
| Shows the |
| Whether the |
{
"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
}
Attribute Code | Description |
|---|---|
| Enigma's unique identifier for the business |
| The various names for the business found in Enigma’s data sources, ordered by prevalence |
| List of addresses for the business containing street, city, state, and postal code |
| The EIN numbers associated with the business |
| The phone numbers associated with the business |
| Year of the earliest incorporation date found in Enigma’s data sources |
| List of website URLs associated with the business |
| Description of the business and its main activities |
{
"aliases": [
"ENIGMA TECHNOLOGIES INC"
],
"ein": [
"12-3456789"
],
"year_incorporated": "2011",
"websites": [
"https://www.enigma.com/"
],
"company_description": [
"Search reliable data on every small business"
]
}
Attribute Code | Description |
|---|---|
| People associated with the business and their titles |
| A registered agent is a business or individual designated to receive service of process when a business is involved in a legal matter |
| The legal structure under which the business is incorporated |
| Estimated headcount for the business based on available sources |
{
"associated_people": [
{
"name": "HICHAM OUDGHIRI",
"titles": [
"OFFICER"
]
}
],
"registered_agents": [
"ENIGMA TECHNOLOGIES INC",
"CORPORATION SERVICE COMPANY"
],
"corporate_structure": "CORPORATION",
"headcount": "100-500"
}
Attribute Code | Description |
|---|---|
| A list of states and corresponding registration dates for state-level corporate registrations found in Enigma’s data sources |
{
"registrations": [
{
"state": "NY",
"issue_date": "2011-11-09",
"file_number": "4163621"
}
]
}
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.
Attribute Code | Description |
|---|---|
| The score from 0 to 1 represents Enigma’s confidence, based on the verification components below. |
{
"verification": {
"score": 0.86,
"components": {
"data_freshness": 1.0,
"source_quality": 1.0,
"data_footprint": 0.53,
"business_activity": 1.0
}
}
}
Attribute Code | Description |
|---|---|
| Whether the business has filed for bankruptcy and a list of the bankruptcy filings’ chapter type, filing date, and case number |
{
"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"
}
]
}
}
Attribute Code | Description |
|---|---|
| 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. |
{
"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"
}
]
}
}
Attribute Code | Description |
|---|---|
| The year issued, type, and expiration date for on any licenses a business has that authorize it to sell firearms |
{
"firearms_licenses": [
{
"type_description": "Pawnbroker in Firearms Other Than Destructive Devices",
"issued_year": "2018",
"expiration_date": "2021-02-01"
}
]
}
Attribute Code | Description |
|---|---|
| A list of Yelp URLs corresponding to Yelp pages associated with the business |
{
"yelp":{
"urls":[
"https://www.yelp.com/biz/nourish-brooklyn-4"
]
}
}
Attribute Code | Description |
|---|---|
| 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"
}
]
}
}
Attribute Code | Description |
|---|---|
| The contractor licenses held by the business in different states, including license types, status, and expiration dates |
{
"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
}
}
| 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. |
|---|
{
"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"
}
]
}
}
Attribute Code | Description |
|---|---|
| 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. |
{
"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
}
]
}
Attribute Code | Description |
|---|---|
| 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. |
{
"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
}
]
}
Attribute Code | Description |
|---|---|
| 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. |
{
"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"
}
]
}
Attribute Code | Description |
|---|---|
| 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. |
{
"operating_status": {
"status": "CLOSED",
"confidence_score": 0.85,
"last_updated": "2020-03-20"
}
}
Attribute Code | Description |
|---|---|
| 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"
}
]
}
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.