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 BoldDataDescription
IDUnique identification number which is important to keep so that you can identify companies in your database
Company NameThe main name of the company
Trade NameAnother name the company might go by
Address StatusFor European records, if we only have the registered address, it will be listed as the physical address
Address 1Where the company is located
Address 2Extra details about the location
CityThe city where the company is situated.
State/ProvinceThe region where the company operates
CountryThe country where the company is located.
Postal CodeThe zip or postal code for the physical location.
Company Registration NumberA official and unique company ID used in some countries for registration and taxes.
Company Registration Type CodeA 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 CodeThe dialing code to reach the country from outside.
Phone NumberThe company phone number (U.S. numbers have area codes, no punctuation).
Cable TelexThe cable or telex number for the company.
Fax NumberThe fax number for the company.
CEO NameThe contact with the highest ranking authority of the company at this location
CEO TitleThe title of the highest ranking authority, possibly abbreviated
Business CategoryA description in English of what the company does
Business Category Code 1The 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 YearA 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 CurrencySales for the company in the local currency. See currency code to determine the currency used.
Yearly Revenue IndicatorCode 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. DollarsSales for the company in U.S. dollars. Currency exchange rate is updated once each year.
Currency CodeCode indicating the currency in which annual sales volume, net worth, and profit-loss are expressed.
Employees On SiteThe number of employees at this location (available for U.S. and Canadian records).
Employees On Site IndicatorIndicates 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 TotalThe total number of employees in the company
Employees Total IndicatorIndicates 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 IndicatorIndicates whether principles are included in the employee total figure ('Y' = included), primarily available on non-U.S. records.
Import/Export CodeIndicates whether the company imports, exports, or acts as an agent. See codes below.
Business Legal TypeCode representing the legal structure of the company. See codes below.
Control IndicatorField not currently in use.
Location TypeIndicates whether the company is a single location, headquarter/parent, or branch. See codes below.
Subsidiary CodeIndicates if a company is a subsidiary. See codes below. This field is populated on linked records only, otherwise empty.
Local Headquarter ID NumberID number of the Local Headquarter that represents the immediate entity above the site. Empty if not linked.
Local Headquarter Company NameThe main name of the Local Headquarter. Empty if not linked.
Local Headquarter Street AddressPhysical street address of the Local Headquarter. Empty if not linked.
Local Headquarter CityName of the city where the Local Headquarter is located. Empty if not linked.
Local Headquarter State/ProvinceThe state/province name in which the Local Headquarter is located. Empty if not linked.
Local Headquarter Country NameName of the country in English where the Local Headquarter is located. Empty if not linked.
National Headquarter ID NumberID 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 NameThe primary name of the National Headquarter Company. Empty if not linked.
National Headquarter Street AddressPhysical street address of the National Headquarter company. Empty if not linked.
National Headquarter City NameName of the city where the National Headquarter is located. Empty if not linked.
National Headquarter State/Province NameName of the state or province in which the National Headquarter is located. Empty if not linked.
Global Headquarter ID NumberThe 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 NameName of the Global Headquarter. Empty if not linked.
Global Headquarter Street AddressPhysical address of the Global Headquarter. Empty if not linked.
Global Headquarter City NameName of the city where the Global Headquarter is located. Empty if not linked.
Global Headquarter State/ProvinceName of the state or province in which the Global Headquarter is located. Empty if not linked.
Global Headquarter Country NameName of the country where the Global Headquarter is located. Empty if not linked.
Number of Companies in GroupThe 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.
WebsiteCompany URL of the company
EmailEmail 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.

Import/Export Codes

CodeDescription
AImport/Export/Agent
BImports & Exports
CImports
DImports & Agents
EExports & Agents
FAgent - keeps no inventory and does not take title to goods
GNot available or none
HExports
EmptyNot available
CodeDescription
0 or EmptyNot available
1 or 13Proprietorship
2 or 7Partnership
3Corporation
8Joint venture
9Master limited partnership
10General partnership
11Limited partnership
12Partnership of unknown type
14Limited liability
15Friendly society

Note: There may be other code values in this field that are currently not defined.

Location Type Codes

CodeDescription
0Single Location - no other entities report to it
1Headquarter/Parent - branches and/or subsidiaries report to it
2Branch - secondary location to a headquarter
EmptyNot available

Subsidiary Codes

CodeDescription
0Not a subsidiary
3Is a subsidiary
EmptyNot linked

Executives Structure (BETA)

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.

FieldTypeDescription
PositionnumberNumeric position/rank of the executive within the company
TitlestringJob title of the executive (e.g., CEO, CFO, Director)
Title CodestringStandardized code representing the job title
First NamestringExecutive's first name
Last NamestringExecutive's last name
GenderstringGender of the executive (Male or Female)
Language PreferencestringISO locale code - see Language Codes

Was this page helpful?