Company API Response Fields

Response Envelope

All API endpoints return JSON with a consistent wrapper. The structure differs between standard and scroll pagination:

Standard pagination (page + pageSize parameters):

{
  "data": {
    "records": [ /* array of company objects */ ],
    "totalCount": 1250
  },
  "page": 1,
  "pageSize": 25,
  "totalPages": 50
}

Scroll pagination (useScroll=true):

{
  "data": [ /* array of company objects */ ],
  "scrollId": "abc123xyz456",
  "hasMoreRecords": true,
  "pageSize": 1000,
  "totalRecords": null
}

The record array is at data.records for standard pagination, and directly at data for scroll pagination. totalCount is not available in scroll mode (totalRecords is always null).

Example Company Record

Below is a representative company object as returned in data.records (standard) or data (scroll). All headquarters fields are flat — there is no nested headquarters object.

{
  "ID": "123456789",
  "Company Name": "BoldData B.V.",
  "Trade Name": null,
  "Address Status": null,
  "Address 1": "Keizersgracht 424",
  "Address 2": null,
  "City": "AMSTERDAM",
  "State/Province": "NOORD-HOLLAND",
  "Country": "Netherlands",
  "Postal Code": "1016 GC",
  "Company Registration Number": "17085670",
  "Company Registration Type Code": "KVK",
  "Country Phone Access Code": "31",
  "Phone Number": "+31201234567",
  "Cable Telex": null,
  "Fax Number": null,
  "CEO Name": "Jane Doe",
  "CEO Title": "CEO",
  "Business Category": "Computer Programming Services",
  "Business Category Code 1": "7371",
  "Business Category Code 1 - Description": "Computer Programming, Data Processing",
  "Founding Year": "2005",
  "Yearly Revenue Local Currency": "1000000",
  "Yearly Revenue Indicator": "0",
  "Yearly Revenue in U.S. Dollars": "1100000",
  "Currency Code": "EUR",
  "Employees On Site": "50",
  "Employees On Site Indicator": "0",
  "Employees Total": "50",
  "Employees Total Indicator": "0",
  "Include Principles Indicator": null,
  "Import/Export Code": "G",
  "Business Legal Type": "14",
  "Control Indicator": null,
  "Location Type": "0",
  "Subsidiary Code": "0",
  "Local Headquarter ID Number": null,
  "Local Headquarter Company Name": null,
  "Local Headquarter Street Address": null,
  "Local Headquarter City": null,
  "Local Headquarter State/Province": null,
  "Local Headquarter Country Name": null,
  "National Headquarter ID Number": "123456789",
  "National Headquarter Company Name": "BoldData B.V.",
  "National Headquarter Street Address": "Keizersgracht 424",
  "National Headquarter City Name": "AMSTERDAM",
  "National Headquarter State/Province Name": "NOORD-HOLLAND",
  "Global Headquarter ID Number": "123456789",
  "Global Headquarter Company Name": "BoldData B.V.",
  "Global Headquarter Street Address": "Keizersgracht 424",
  "Global Headquarter City Name": "AMSTERDAM",
  "Global Headquarter State/Province": "NOORD-HOLLAND",
  "Global Headquarter Country Name": "Netherlands",
  "Number of Companies in Group": "1",
  "Website": "https://bolddata.com",
  "Email": "info@bolddata.nl",
  "Executives": null
}

Not all fields are returned — this depends on your subscription package. Contact support to receive additional fields. Numeric fields (revenue, employee counts) are returned as strings, not numbers.

Company Record Fields

All string fields may be null or empty string when data is unavailable. Numeric values (revenue, employee counts, founding year) are returned as strings and must be parsed by the client.

Field	Type	Description
ID	string	Unique identifier for the company record. Store this to retrieve or reference the company in future requests without re-searching.
Company Name	string	Primary registered name of the company.
Trade Name	string \| null	Alternative or "doing business as" (DBA) name the company may operate under.
Address Status	string \| null	Indicates the address type on file. For European records, if only the registered address is available, it is used as the physical address and this field flags that.
Address 1	string \| null	Primary street address (street name and building number).
Address 2	string \| null	Secondary address details (suite, floor, building name).
City	string \| null	City of the company location.
State/Province	string \| null	State or province of the company location.
Country	string \| null	Country name in English (e.g., `"Netherlands"`, `"United States"`).
Postal Code	string \| null	Postal or ZIP code. Always a string — may contain letters (e.g., `"1016 GC"`). Filter: `postalCode` (exact), `postalCodeInteger` (numeric range).
Company Registration Number	string \| null	Official national registration ID (e.g., Dutch KvK number, UK Companies House number). See `Company Registration Type Code` for which system applies. Filter: `nationalId`.
Company Registration Type Code	string \| null	Code identifying the national registration system used (e.g., `"KVK"` for the Netherlands, `"CRO"` for the UK). Use this to determine how to validate or format `Company Registration Number`.
Country Phone Access Code	string \| null	International dialing prefix without leading `+` or `00` (e.g., `"31"` for the Netherlands, `"1"` for the US).
Phone Number	string \| null	Company phone number. US numbers include area code with no punctuation. Filter: `phoneNumber`, `hasPhone`.
Cable Telex	string \| null	Legacy cable or telex number. Rarely populated on modern records.
Fax Number	string \| null	Company fax number. Filter: `hasFax`.
CEO Name	string \| null	Name of the highest-ranking contact at this location. Also available as Position 1 in the `Executives` array when executive data is enabled on your account. Filter: `hasCEOName`, `hasContactPerson`.
CEO Title	string \| null	Title of the CEO or top contact, possibly abbreviated (e.g., `"Pres"`, `"Dir"`, `"CEO"`).
Business Category	string \| null	Plain-English description of the company's primary activity (e.g., `"Computer Programming Services"`).
Business Category Code 1	string \| null	Primary 4-digit SIC code (1987 U.S. classification system). Filter: `sic4Digits`.
Business Category Code 1 - Description	string \| null	Description of the primary SIC code (e.g., `"Computer Programming, Data Processing"`).
Founding Year	string \| null	Four-digit year the current ownership took control, or the founding year if no change of control occurred. Not available for branch records. Filter: `foundingYears[min]` / `foundingYears[max]`.
Yearly Revenue Local Currency	string \| null	Annual sales in the local currency. See `Currency Code` for the applicable currency.
Yearly Revenue Indicator	string \| null	Data quality flag for `Yearly Revenue Local Currency`. `"0"` = actual figure, `"1"` = low-end range estimate, `"2"` = estimated (also used when the revenue value is zero), empty/null = not available.
Yearly Revenue in U.S. Dollars	string \| null	Annual sales in USD. Exchange rate updated once per year. Filter: `annualSales[min]` / `annualSales[max]`.
Currency Code	string \| null	ISO 4217 currency code for `Yearly Revenue Local Currency` (e.g., `"EUR"`, `"USD"`, `"GBP"`).
Employees On Site	string \| null	Number of employees at this specific location. Available primarily for US and Canadian records. Filter: `employeesHere[min]` / `employeesHere[max]`.
Employees On Site Indicator	string \| null	Data quality flag for `Employees On Site`. `"0"` = actual figure, `"1"` = low-end estimate, `"2"` = estimated (also used when the value is zero), empty/null = not available.
Employees Total	string \| null	Total number of employees across the entire company. Filter: `employeesTotal[min]` / `employeesTotal[max]`.
Employees Total Indicator	string \| null	Data quality flag for `Employees Total`. `"0"` = actual figure, `"1"` = low-end estimate, `"2"` = estimated (also used when the value is zero), empty/null = not available.
Include Principles Indicator	string \| null	Whether business owners or partners are counted in `Employees Total`. `"Y"` = included, empty/null = not included or unknown. Available primarily on non-US records.
Import/Export Code	string \| null	Trade activity of the company. `"A"` = imports, exports & agent, `"B"` = imports & exports, `"C"` = imports only, `"D"` = imports & agent, `"E"` = exports & agent, `"F"` = agent only (no inventory), `"G"` = none or not available, `"H"` = exports only, empty = not available. Filter: `importExportCode`.
Business Legal Type	string \| null	Legal entity type code. `"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 (unknown type), `"14"` = limited liability, `"15"` = friendly society, `"0"` or empty = not available. Other values may exist. Filter: `legalStatus`.
Control Indicator	string \| null	Reserved field, not currently in use.
Location Type	string \| null	Company's role in its corporate hierarchy. `"0"` = single location (no entities report to it), `"1"` = headquarter/parent (branches and/or subsidiaries report to it), `"2"` = branch (secondary location of a headquarter), empty = not available. Filter: `statusCode`.
Subsidiary Code	string \| null	Subsidiary status. `"0"` = not a subsidiary, `"3"` = is a subsidiary, empty = not linked. Populated on linked records only. Filter: `subsidiaryCode`.
Local Headquarter ID Number	string \| null	`ID` of the immediate parent entity above this location. Pass this value as the `ID` filter to fetch that record. Empty if not linked.
Local Headquarter Company Name	string \| null	Name of the immediate parent entity. Empty if not linked.
Local Headquarter Street Address	string \| null	Street address of the immediate parent entity. Empty if not linked.
Local Headquarter City	string \| null	City of the immediate parent entity. Empty if not linked.
Local Headquarter State/Province	string \| null	State/province of the immediate parent entity. Empty if not linked.
Local Headquarter Country Name	string \| null	Country name of the immediate parent entity. Empty if not linked.
National Headquarter ID Number	string \| null	`ID` of the highest entity within the same country as this location. May equal this company's own `ID` if it is the national top.
National Headquarter Company Name	string \| null	Name of the national-level parent. Empty if not linked.
National Headquarter Street Address	string \| null	Street address of the national-level parent. Empty if not linked.
National Headquarter City Name	string \| null	City of the national-level parent. Empty if not linked.
National Headquarter State/Province Name	string \| null	State/province of the national-level parent. Empty if not linked.
Global Headquarter ID Number	string \| null	`ID` of the ultimate worldwide parent of the corporate group. All companies in the group share this value. Pass this to the `worldwideHeadquarterID` filter to fetch all entities in the group.
Global Headquarter Company Name	string \| null	Name of the ultimate worldwide parent. Empty if not linked.
Global Headquarter Street Address	string \| null	Street address of the ultimate worldwide parent. Empty if not linked.
Global Headquarter City Name	string \| null	City of the ultimate worldwide parent. Empty if not linked.
Global Headquarter State/Province	string \| null	State/province of the ultimate worldwide parent. Empty if not linked.
Global Headquarter Country Name	string \| null	Country name of the ultimate worldwide parent. Empty if not linked.
Number of Companies in Group	string \| null	Total number of entities in the worldwide corporate group (HQ + all subsidiaries and branches). All group members share this count. Empty if not linked.
Website	string \| null	Company website URL. Filter: `hasWebsite`.
Email	string \| null	Company email address(es). May contain multiple addresses separated by commas. Filter: `email`, `hasEmail`.
Executives (BETA)	array \| null	Array of executive/management personnel objects. Up to 11 executives per company. Null if executive data is not enabled or not available. 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.

Query Parameter to Response Field Reference

Query parameter names do not always match the response field names they correspond to. This table provides the explicit mapping.

Query Parameter	Corresponding Response Field	Notes
`ID`	`ID`	Exact match
`search`	`Company Name`	Full-text search on name
`nationalId`	`Company Registration Number`	—
`countryCode`	(no direct field — use `Country` for the name)	ISO 2-letter code used for filtering only
`countryName`	`Country`	Exact match required
`cityName`	`City`	Exact match required
`provinceName`	`State/Province`	Exact match required
`regionName`	`State/Province`	Region variant; exact match required
`postalCode`	`Postal Code`	Exact string match
`postalCodeInteger`	`Postal Code`	Numeric range filter on postal code
`streetName`	`Address 1`	Prefix (partial) match
`sic4Digits`	`Business Category Code 1`	—
`statusCode`	`Location Type`	Codes: `0`=single, `1`=HQ, `2`=branch
`legalStatus`	`Business Legal Type`	Same numeric codes
`subsidiaryCode`	`Subsidiary Code`	Same numeric codes
`importExportCode`	`Import/Export Code`	Same letter codes
`employeesHere[min/max]`	`Employees On Site`	Range filter
`employeesTotal[min/max]`	`Employees Total`	Range filter
`annualSales[min/max]`	`Yearly Revenue in U.S. Dollars`	Range filter in USD
`foundingYears[min/max]`	`Founding Year`	Range filter
`worldwideHeadquarterID`	`Global Headquarter ID Number`	Fetches all entities in a corporate group
`phoneNumber`	`Phone Number`	Full number with country code
`email`	`Email`	Email address or domain pattern
`hasEmail`	`Email`	Returns only companies with a non-empty `Email` field
`hasPhone`	`Phone Number`	Returns only companies with a non-empty `Phone Number`
`hasFax`	`Fax Number`	Returns only companies with a non-empty `Fax Number`
`hasWebsite`	`Website`	Returns only companies with a non-empty `Website`
`hasContactPerson`	`CEO Name`	Returns only companies with a non-empty `CEO Name`
`hasCEOName`	`CEO Name`	Returns only companies with a non-empty `CEO Name`
`hasNationalID`	`Company Registration Number`	Returns only companies with a registration number
`hasStreetAddress`	`Address 1`	Returns only companies with a street address
`hasPostalCode`	`Postal Code`	Returns only companies with a postal code
`hasBusinessName`	`Company Name`	Returns only companies with a name on file
`hasMarketability`	(internal flag, no direct response field)	Filters for marketable records

Executives Structure (BETA)

This feature is currently in beta. We are still researching and improving executive data coverage.

The Executives field is an array of objects. Each object represents one executive. Executives are only included if they have at least a first name or last name. Up to 11 executives can be returned per company. All fields within each executive object may be null.

{
  "Executives": [
    {
      "Position": 1,
      "Title": "CEO",
      "Title Code": "100",
      "First Name": "Jane",
      "Last Name": "Doe",
      "Gender": "Female",
      "Language Preference": "en-US"
    },
    {
      "Position": 2,
      "Title": "CFO",
      "Title Code": "200",
      "First Name": "John",
      "Last Name": "Smith",
      "Gender": "Male",
      "Language Preference": "en-US"
    }
  ]
}

Field	Type	Description
Position	number \| null	Numeric rank of the executive within the company (1 = most senior)
Title	string \| null	Job title of the executive (e.g., `"CEO"`, `"CFO"`, `"Director"`)
Title Code	string \| null	Standardized internal code representing the job title
First Name	string \| null	Executive's first name
Last Name	string \| null	Executive's last name
Gender	string \| null	Gender of the executive (`"Male"` or `"Female"`)
Language Preference	string \| null	ISO locale code indicating the executive's preferred language — see Language Codes