Company API Response Fields
Below are the descriptions for the fields that may be returned in the API response.
Note: not all fields are returned, this depends on the package you've purchased, talk to support if you to receive more fields.
| Field Name BoldData | Description |
|---|---|
| ID | Unique identification number which is important to keep so that you can identify companies in your database |
| Company Name | The main name of the company |
| Trade Name | Another name the company might go by |
| Address Status | For European records, if we only have the registered address, it will be listed as the physical address |
| Address 1 | Where the company is located |
| Address 2 | Extra details about the location |
| City | The city where the company is situated. |
| State/Province | The region where the company operates |
| Country | The country where the company is located. |
| Postal Code | The zip or postal code for the physical location. |
| Company Registration Number | A official and unique company ID used in some countries for registration and taxes. |
| Company Registration Type Code | A code that identifies the type of national ID number system used in each country. Examples include CRO numbers in the U.K. and the Dutch KvK numbers. |
| Country Phone Access Code | The dialing code to reach the country from outside. |
| Phone Number | The company phone number (U.S. numbers have area codes, no punctuation). |
| Cable Telex | The cable or telex number for the company. |
| Fax Number | The fax number for the company. |
| CEO Name | The contact with the highest ranking authority of the company at this location |
| CEO Title | The title of the highest ranking authority, possibly abbreviated |
| Business Category | A description in English of what the company does |
| Business Category Code 1 | The main activity code based on the 1987 U.S. classification system |
| **Business Category Code 1 - Description ** | Description of the main activity code based on the 1987 U.S. classification system |
| Founding Year | A four-digit field representing the year the current ownership took control or the year the company was established if no change in control occurred. Not available for branch records. |
| Yearly Revenue Local Currency | Sales for the company in the local currency. See currency code to determine the currency used. |
| Yearly Revenue Indicator | Code describing the sales volume ('0' = actual, '1' = low end of range, '2' = estimated or not available if sales value is zero; Empty = not available). |
| Yearly Revenue in U.S. Dollars | Sales for the company in U.S. dollars. Currency exchange rate is updated once each year. |
| Currency Code | Code indicating the currency in which annual sales volume, net worth, and profit-loss are expressed. |
| Employees On Site | The number of employees at this location (available for U.S. and Canadian records). |
| Employees On Site Indicator | Indicates the availability of information on the number of employees at this location ('0' = actual, '1' = low end of range, '2' = estimated or not available if employees here value is zero; Empty = not available). |
| Employees Total | The total number of employees in the company |
| Employees Total Indicator | Indicates the availability of information on the total number of employees in the company ('0' = actual, '1' = low end of range, '2' = estimated or not available if employees here value is zero; Empty = not available). |
| Include Principles Indicator | Indicates whether principles are included in the employee total figure ('Y' = included), primarily available on non-U.S. records. |
| Import/Export Code | Indicates whether the company imports, exports, or acts as an agent. See codes below. |
| Business Legal Type | Code representing the legal structure of the company. See codes below. |
| Control Indicator | Field not currently in use. |
| Location Type | Indicates whether the company is a single location, headquarter/parent, or branch. See codes below. |
| Subsidiary Code | Indicates if a company is a subsidiary. See codes below. This field is populated on linked records only, otherwise empty. |
| Local Headquarter ID Number | ID number of the Local Headquarter that represents the immediate entity above the site. Empty if not linked. |
| Local Headquarter Company Name | The main name of the Local Headquarter. Empty if not linked. |
| Local Headquarter Street Address | Physical street address of the Local Headquarter. Empty if not linked. |
| Local Headquarter City | Name of the city where the Local Headquarter is located. Empty if not linked. |
| Local Headquarter State/Province | The state/province name in which the Local Headquarter is located. Empty if not linked. |
| Local Headquarter Country Name | Name of the country in English where the Local Headquarter is located. Empty if not linked. |
| National Headquarter ID Number | ID Number for the National Headquarter represents the highest member of the company group within the same country as the site. A case may be its own National Headquarter. |
| National Headquarter Company Name | The primary name of the National Headquarter Company. Empty if not linked. |
| National Headquarter Street Address | Physical street address of the National Headquarter company. Empty if not linked. |
| National Headquarter City Name | Name of the city where the National Headquarter is located. Empty if not linked. |
| National Headquarter State/Province Name | Name of the state or province in which the National Headquarter is located. Empty if not linked. |
| Global Headquarter ID Number | The ID number of the upper most parent of a corporate group. Global Headquarter records carry their own case ID number in this field so that a common sort and/or match area is available for all group members. Empty if not linked. |
| Global Headquarter Company Name | Name of the Global Headquarter. Empty if not linked. |
| Global Headquarter Street Address | Physical address of the Global Headquarter. Empty if not linked. |
| Global Headquarter City Name | Name of the city where the Global Headquarter is located. Empty if not linked. |
| Global Headquarter State/Province | Name of the state or province in which the Global Headquarter is located. Empty if not linked. |
| Global Headquarter Country Name | Name of the country where the Global Headquarter is located. Empty if not linked. |
| Number of Companies in Group | The number of companies in the global group including the Global Headquarter and all subsidiaries and branches of the entire organizational group globally. Every company in the organizational chart carries the same count. Empty if not linked. |
| Website | Company URL of the company |
| Email addresses of the company | |
| Executives (BETA) | Executive/management personnel data. Each company can have up to 11 executives (Exec01 - Exec11). This feature is currently in beta - we are still researching and improving coverage. See structure below. |
We aim to provide accurate and up-to-date data, but returned fields may contain errors, be incomplete, or change without notice. See our Data Disclaimer for more details.
Import/Export Codes
| Code | Description |
|---|---|
| A | Import/Export/Agent |
| B | Imports & Exports |
| C | Imports |
| D | Imports & Agents |
| E | Exports & Agents |
| F | Agent - keeps no inventory and does not take title to goods |
| G | Not available or none |
| H | Exports |
| Empty | Not available |
Business Legal Type Codes
| Code | Description |
|---|---|
| 0 or Empty | Not available |
| 1 or 13 | Proprietorship |
| 2 or 7 | Partnership |
| 3 | Corporation |
| 8 | Joint venture |
| 9 | Master limited partnership |
| 10 | General partnership |
| 11 | Limited partnership |
| 12 | Partnership of unknown type |
| 14 | Limited liability |
| 15 | Friendly society |
Note: There may be other code values in this field that are currently not defined.
Location Type Codes
| Code | Description |
|---|---|
| 0 | Single Location - no other entities report to it |
| 1 | Headquarter/Parent - branches and/or subsidiaries report to it |
| 2 | Branch - secondary location to a headquarter |
| Empty | Not available |
Subsidiary Codes
| Code | Description |
|---|---|
| 0 | Not a subsidiary |
| 3 | Is a subsidiary |
| Empty | Not linked |
Executives Structure (BETA)
This feature is currently in beta. We are still researching and improving executive data coverage.
Each executive object contains the following fields. Executives are only included if they have at least a first name or last name. All fields may return null.
| Field | Type | Description |
|---|---|---|
| Position | number | Numeric position/rank of the executive within the company |
| Title | string | Job title of the executive (e.g., CEO, CFO, Director) |
| Title Code | string | Standardized code representing the job title |
| First Name | string | Executive's first name |
| Last Name | string | Executive's last name |
| Gender | string | Gender of the executive (Male or Female) |
| Language Preference | string | ISO locale code - see Language Codes |