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.
Our basic attributes help you identify the right businesses for easy integration into your workflows.
Unlike other data providers, we wonât charge you for core small business firmographics. We provide basic attributes free for all customers, making it easy for you to evaluate business matches and integrate our data with your existing workflows.
Attributes |
|---|
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 Child Attributes`name` `address` `person`Child Attributes`street_address1` `street_address2` `city` `state` `postal_code` `person`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 |
{
"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
}
Attributes |
|---|
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 |
{
"aliases": [
"ENIGMA TECHNOLOGIES INC"
],
"ein": [
"12-3456789"
],
"year_incorporated": "2011",
"websites": [
"https://www.enigma.com/"
],
"company_description": [
"Search reliable data on every small business"
]
}
Attributes |
|---|
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"
}
Attributes |
|---|
A list of states and corresponding registration dates for state-level corporate registrations found in Enigmaâs data sources Child Attributes`state` `issue_date` `file_number` |
{
"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.
Attributes |
|---|
The average monthly number of credit and debit card transactions at a business across 1 month, 3 month and 12 month periods. Child Attributes`end_date`The date of this attribute's most recent data on this business. All fields below assume this is the final date, inclusive, of the calculation.
Child Attributes`start_date`The date that the 1-month period begins, inclusive. `count`The average monthly number of transactions over the month leading up to and including end_date. For example, the value for the 1m period ending at 2020-04-30 is the average monthly transaction count from 2020-04-01 to 2020-04-30 inclusive. NOTE: This field should be interpreted along with the Whether or not we have transactions for the given business in the 1-month period. Child Attributes`start_date`The date that the 3-month period begins, inclusive. `count`The average monthly number of transactions over the 3 months leading up to and including end_date. For example, the value for the 3m period ending at 2020-04-30 is the average monthly transaction count from 2020-02-01 to 2020-04-30 inclusive. NOTE: This field should be interpreted along with the Whether or not we have transactions for the given business in the 3-month period. Child Attributes`start_date`The date that the 12-month period begins, inclusive. `count`The average monthly number of transactions over the 12 months leading up to and including end_date. For example, the value for the 12m period ending at 2020-04-30 is the average monthly transaction count from 2019-05-01 to 2020-04-30 inclusive. NOTE: This field should be interpreted along with the Whether or not we have transactions for the given business in the 12-month period. |
{
"card_transactions": {
"end_date": "2020-08-31",
"1m": {
"start_date": "2020-08-01",
"count": null,
"present": true
},
"3m": {
"start_date": "2020-06-01",
"count": 140,
"present": true
},
"12m": {
"start_date": "2019-09-01",
"count": 250,
"present": true
}
}
}
Attributes |
|---|
The average monthly revenue a business receives from credit and debit card transactions across 1 month, 3 month and 12 month periods. Child Attributes`end_date`The date of this attribute's most recent data on this business. All fields below assume this is the final date, inclusive, of the calculation.
Child Attributes`start_date`The date that the 1-month period begins, inclusive. `amount`The business's card revenue in the 1 month leading up to and including end_date, Child Attributes`start_date`The date that the 3-month period begins, inclusive. `amount`The business's average monthly card revenue in the 3 months leading up to and including end_date, Child Attributes`start_date`The date that the 12-month period begins, inclusive. `amount`The business's average monthly card revenue in the 12 months leading up to and including end_date, |
{
"card_revenue": {
"end_date": "2020-08-31",
"1m": {
"start_date": "2020-08-01",
"amount": 1200.11
},
"3m": {
"start_date": "2020-06-01",
"amount": 1400.77
},
"12m": {
"start_date": "2019-09-01",
"amount": 3200.80
}
}
Attributes |
|---|
The revenue growth trends at a business, measured across 3 month, 3 month (seasonally adjusted) and 12 month periods. Child Attributes`end_date`The date of this attribute's most recent data on this business. All fields below assume this is the final date, inclusive, of the calculation.
Child Attributes`start_date`The date that the 3-month period begins, inclusive. `percent`The change in revenue in the past 3 months from the 3 months prior, expressed as a percentage, The change in revenue in the past 3 months from the corresponding 3 months a year prior, expressed as a percentage, Child Attributes`start_date`The date that the 12-month period begins, inclusive. `percent`The change in revenue in the past 12 months from the 12 months prior, expressed as a percentage, |
{
"card_revenue_growth": {
"end_date": "2020-08-31",
"3m": {
"start_date": "2020-06-01",
"percent": 13.20,
"percent_sa": 2.18
},
"12m": {
"start_date": "2019-09-01",
"percent": 13.38
}
}
}
Attributes |
|---|
The daily average number of customers a business has, based on credit and debit card transactions, across 1 month, 3 month, and 12 month periods. Child Attributes`end_date`The date of this attribute's most recent data on this business. All fields below assume this is the final date, inclusive, of the calculation.
Child Attributes`start_date`The date that the 1-month period begins, inclusive. `avg_daily_count`The business's average daily customer count in the 1 month leading up to and including end_date, Child Attributes`start_date`The date that the 3-month period begins, inclusive. `avg_daily_count`The business's average daily customer count in the 3 months leading up to and including end_date, Child Attributes`start_date`The date that the 12-month period begins, inclusive. `avg_daily_count`The business's average daily customer count in the 12 months leading up to and including end_date, |
{
"card_customers": {
"end_date": "2020-08-31",
"1m": {
"start_date": "2020-08-01",
"avg_daily_count": 10
},
"3m": {
"start_date": "2020-06-01",
"avg_daily_count": 30
},
"12m": {
"start_date": "2019-09-01",
"avg_daily_count": 70
}
}
}
Attributes |
|---|
The score from 0 to 1 represents Enigmaâs confidence, based on the verification components below. Child Attributes`score` `components`Child Attributes`data_freshness`The recency of data observed about the business `source_quality`The trustworthiness of sources in which the data is found `data_footprint`The breadth of data available about the business `business_activity`A measure of recent activity observed in our data sources |
{
"verification": {
"score": 0.86,
"components": {
"data_freshness": 1.0,
"source_quality": 1.0,
"data_footprint": 0.53,
"business_activity": 1.0
}
}
}
Attributes |
|---|
Whether the business has filed for bankruptcy and a list of the bankruptcy filingsâ chapter type, filing date, and case number Child Attributes`bankruptcy_flag`Yes/No whether the business has at least one bankruptcy record `bankruptcy_records`Child Attributes`chapter_type`Chapter 7, 11, or 13 `filing_date`Date of bankruptcy filing `case_number`Case number corresponding to bankruptcy filing |
{
"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"
}
]
}
}
Attributes |
|---|
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. Child Attributes`total_inspections`Total number of OSHA inspections recorded for the business `total_violations`Total number of OSHA violations recorded for the business `violations_inspections_ratio`Ratio of violations to the number of OSHA inspections `months_since_inspection`Months elapsed since last inspection `months_since_violation`Month elapsed since last violation `violation_details`Child Attributes`standard_violated`Numberical code for OSHA standard violated `record_type`Indicates the level of seriousness of the violation `case_number`The case number for the violation `hazard_category`The type of hazard found in the violation `filing_date`The date on which the violation was filed `current_penalty`The financial penalty outstanding `issuance_date`The date on which the violation was issued |
{
"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"
}
]
}
}
Attributes |
|---|
The year issued, type, and expiration date for on any licenses a business has that authorize it to sell firearms Child Attributes`type_description`The type of firearms license issued to the business `issued_year`The year in which the license was issue `expiration_date`The date on which the license expires |
{
"firearms_licenses": [
{
"type_description": "Pawnbroker in Firearms Other Than Destructive Devices",
"issued_year": "2018",
"expiration_date": "2021-02-01"
}
]
}
Attributes |
|---|
A list of Yelp URLs corresponding to Yelp pages associated with the business Child Attributes`urls`The Yelp URLs associated with the business |
{
"yelp":{
"urls":[
"https://www.yelp.com/biz/nourish-brooklyn-4"
]
}
}
Attributes |
|---|
The overall number, value, and status of loans the businesses have received from the SBA, as well as individual loan details. Child Attributes`total_number`The total number of SBA loans
The total amount approved in USD
The total number of active loans
The total amount active in USD
The number of loans with charge offs
The total amount active in USD
Child Attributes`approval_date` `loan_status` `gross_approval_amount` `loan_type` |
{
"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"
}
]
}
}
Attributes |
|---|
A list of all construction contractor licenses this business has been awarded, state-by-state, in the states we cover. Child Attributes`state`The state in which this license was issued. Child Attributes`has_license_history`Whether or not the business has a license in that state. `licenses`A list of all contracts the business has in that state, each with four standard fields. Child Attributes`license_number`A standard field pulled from whichever column in `details` most closely represents the license number. `start_date`A standard field pulled from whichever column in `details` most closely represents the license's start date. `end_date`A standard field pulled from whichever column in `details` most closely represents the license's end date. `classification`A standard field pulled from whichever column in `details` most closely represents what type of work the license is for.
A list of additional fields that come directly from the source. There will be a different set with more or fewer fields depending on the state and license classification. The ones listed below are for illustration to give a sense of what this could look like. Child Attributes`issue_date`Date on which the license was issued `reissue_date`Date on which the license was re-issued, if applicable `effective_date`Effective date for the license `expiration_date`Expiration date for the license `license_number`Identifying number for the license `primary_status`The primary purpose for which the construction license is used `license_type`The type of construction activities covered by the license |
{
"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
}
}
Attributes |
|---|
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. Child Attributes`aggregate`The business's contracts aggregated by start year, skipping years in which they received no contracts. We aggregate by the contract's start year to reveal how much pre-committed revenue the business earns each year. If a contract has no year, it is aggregated into `"unknown_year"`. Child Attributes`year`Year of aggregation. `location`A list of all geographies from which the business was awarded a contract this year. `total_number`The total number of contracts the business has won this year. `total_value`The total value of all contracts the business was awarded this year. NOTE: some contracts are published as 0 or null so are not included in the aggregation. Child Attributes`details`The business's contracts one-by-one, sorted by start_date with limit 50. Child Attributes`location`The city, state, or "USA" granting the contract. `agency_name`The department awarding the contract. `amount`The dollar value of this contract. NOTE: some government agencies publish this as 0 or null on some contracts. `description`A description of the contract. `start_date`The start date of the contract. `end_date`The end date of the contract. |
{
"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"
}
]
}
}
Attributes |
|---|
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. Child Attributes`country_name`Country from which the shipments originated `period`Week of the year during which the shipments took place `quantity`The number of shipments recorded |
{
"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
}
]
}
Attributes |
|---|
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. Child Attributes`enigma_industry`Enigma's custom classification for the industry that describes the business' activities `sector`The sector in which the business operates, as classified by predicted GICS `industry_group`The high-level industry group in which the business operates `industry`The specific industry category in which the business operates `sub_industry`The detailed, granular industry category in which the business operates `predicted_naics_code`The predicted NAICS code corresponding to the business' industry classification `predicted_gics_code`The predicted GICS code corresponding to the business' sector classification _âGICSâ is the trademark of Standard & Poorâs Financial Services LLC (S&P) and MSCI. Use of "GICS" does not imply any affiliation with or endorsement by S&P or MSCI._ |
{
"industry_beta": [
{
"enigma_industry": "Construction and Engineering",
"sector": "Industrials",
"industry_group": "Capital Goods",
"industry": "Construction and Engineering",
"sub_industry": "Construction and Engineering",
"predicted_naics_code": 23,
"predicted_gics_code": 20103010
},
{
"enigma_industry": "Construction Materials",
"sector": "Materials",
"industry_group": "Materials",
"industry": "Construction Materials",
"sub_industry": null,
"predicted_naics_code": 23,
"predicted_gics_code": 15102010
}
]
}
Attributes |
|---|
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. Child Attributes`layoff_or_closing`either "layoff" or "closing" depending on what the notification was.
The date on which the notice was received.
The number of employees impacted.
The total headcount before the layoff.
The percent of employees laid off
The date on which the layoffs will occur.
Unforeseeable business circumstances prompted by COVID-19 |
{
"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"
}
]
}
Attributes |
|---|
Business closures as reported across web sources including Yelp, Eater, the businessâs website, and government sources. Closures are marked with status = closed. A null status indicates the business is open. Child Attributes`status`"Closed" if the business is observed to be closed, null if open, empty if no data found `confidence_score`A measure of confidence in the operating status returned `last_updated`The date on which the operating status information was last updated |
{
"operating_status": {
"status": "CLOSED",
"confidence_score": 0.85,
"last_updated": "2020-03-20"
}
}
Attributes |
|---|
List of a company's corporate registrations, with full details Child Attributes`business_name`The business name as it appears in the corporate registration
"Domestic", "foreign", or "unknown"
The mailing address of the business address as it appears in the corporate registration
The main address of the business as it appears in the corporate registration
the physical address of the business as it appears in the corporate registration
The physical address of the business as it appears in the corporate registration
The business state of jurisdiction as it appears in the corporate registration |
{
"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.
See more details in the Pricing page