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.
- Output: Number from 0 to 1
- Interpretation: 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
- Output: Name, address, person
- Interpretation: Shows the name, address, and person in Enigma’s data asset that were found in relation to the user’s query
- Output: True/False
- Interpretation: Whether the match_confidence for the returned business exceeds the match threshold. To return non-matches, set
show-non-matches: 1in your request parameters
- Output: List of business names
- Interpretation: The various names for the business found in Enigma’s data sources, ordered by prevalence
- Output: List of addresses containing street, city, state, and postal code
- Interpretation: The various addresses for the business found in Enigma’s data sources
- Output: List of EIN numbers
- Interpretation: The EIN numbers associated with the business
- Output: List of phone numbers
- Interpretation: The phone numbers associated with the business
- Output: Year
- Interpretation: Year of the earliest incorporation date found in Enigma’s data sources
- Output: List of website URLs
- Interpretation: The websites associated with the business
- Output: Paragraph description
- Interpretation: Description of the business and its main activities
- Output: List of person objects containing name and title
- Interpretation: People associated with the business and their titles
- Output: List of registered agents names
- Interpretation: A registered agents is a business or individual designated to receive service of process when a business is involved in a legal matter
- Output: One of Corporation, LP, LLP, LLC, Non-Profit, DBA
- Interpretation: The legal structure under which the business is incorporated
- Output: A headcount range estimate
- Interpretation: Estimated headcount for the business based on available sources
- Output: Industry name
- Interpretation: High-level industry classification for the business
NAICS 2-digit code
- Output: 2-digit numeric code
- Interpretation: NAICS industry classification at the 2-digit level
State-Level Corporate Registrations
- Output: A list of states and dates
- Interpretation: The states and corresponding registration dates for state-level corporate registrations found in Enigma’s data sources
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
def, append the query parameters
?attrs=abc,def to the end of the URL for the ID endpoint. See Getting Started for more details.
The code for verification is
ver and can be exposed by setting the query parameter
?attrs=ver at the end of the URL for the ID endpoint.
- Output: Score from 0 to 1
- Interpretation: The score represents Enigma’s confidence, based on the verification components below.
- Output: The component scores that contribute to the verification score, each from 0 to 1
Data freshness- Represents the recency of Enigma’s records on the business
Source quality- Represents the quality of the sources in which the business appears Government sources are considered highest quality; 3rd-party data quality is determined based on provider methodology
Data footprint- Represents the breadth/depth of information available on the business
Business activity- Represents Enigma’s confidence that the business is currently open and active
- Output: Whether the business has filed for bankruptcy and a list of the bankruptcy filings’ chapter type, filing date, and case number
- Interpretation: Whether the business has filed for bankruptcy
OSHA Inspections & Violations
- Output: The number and recency of OSHA inspections and violations, as well as details on each violation.
- Interpretation: 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.
- Output: Details on any licenses a business has that authorize it to sell firearms
- Interpretation: The year issued, type, and expiration date for all firearm licenses a business has
- Output: A list of Yelp URLs
- Intepretation: URLs corresponding to Yelp pages associated with the business
- Output: Whether a business is permanently closed
- Intepretation: A business is considered closed if we find sources online indicating its permanent closure
- Output: A list where each entry is a country name, a time period (week of the year), and a number of shipments
- Interpretation: The number of shipments imported by the business in the last year, broken out by country of origin and week of the year
- Output: A list of contractor licenses and corresponding metadata organized by state
- Interpretation: The contractor licenses held by the business in different states, including license types, status, and expiration dates
- The aggregate number, value, & locations of all government contracts the business has been awarded
- The amount, locale, and date details of each contract.
- Interpretation: 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.
We provide 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.
- Enigma Industry: The predicted industry of the company, according to Enigma’s custom industry taxonomy.
- Sector: Mapping of the predicted Enigma industry to a GICS sector, provided for ease of integration.
- Industry Group: Mapping of the predicted Enigma industry to a GICS industry group, provided for ease of integration.
- Industry: Mapping of the predicted Enigma industry to a GICS industry, provided for ease of integration.
- Sub-Industry: Mapping of the predicted Enigma industry to a GICS sub-industry, provided for ease of integration.
- GICS Code: Mapping of the predicted Enigma industry to a GICS code, provided for ease of integration
- NAICS Code: Mapping of the predicted Enigma industry to a NAICS code, provided for ease of integration
- Interpretation: A description of the industries a business belongs to according to Enigma’s industry taxonomy.
WARN Act Notifications - NY
- Output: One entry per WARN notification containing details on the number of employees and date of layoff.
- Interpretation: 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.