Skip to main content

Lightcast Companies Data Guide

Explore the Lightcast Companies Data Guide for organization coverage, company identifiers, hierarchies, industry classifications, attributes, and data updates.

Overview

Lightcast Companies is a global organization database designed for organizational and workforce intelligence. It brings together standardized company identities, firmographic attributes, geographic information, industry classifications, and organizational relationships to support analysis of organizations across markets.

This guide explains the database's coverage, key attributes, organizational structure, data quality, and maintenance. For a general introduction to the product, see Lightcast Companies Overview.

1. Coverage and Organizational Scope

Lightcast Companies covers organizations across commercial, government, education, and nonprofit sectors, from small businesses to multinational enterprises.

The database focuses on organizations with meaningful operational presence and relevance to workforce and labor market activity, including major employers, publicly traded companies, high-growth businesses, and organizations across key industries.

It includes operating companies and where identified, their subsidiaries, branches, selected brands, and joint ventures. These may be represented as distinct records within the same corporate group.

Coverage extends beyond organizations currently used in Lightcast job postings and profiles. However, Lightcast Companies is not intended to be an exhaustive registry of all legally registered businesses or physical establishments. Coverage varies by geography, organization size, and the availability of reliable company information.

For more information about coverage, see the Overall Coverage Summary and Country-Level Coverage Summary.

2. Company Identity and Identifiers

Each organization record has a unique company_id, designed to remain associated with the same company throughout its lifecycle. Changes to company names, addresses, websites, or other attributes generally do not require a new identifier when the underlying organization remains the same.

When companies merge, the identifier of the main surviving legal entity is generally retained. An acquired company that continues operating independently may retain its own identifier, while a genuinely new business entity receives a new ID.

Company IDs are not reused for unrelated organizations. You should use company_id rather than company names when maintaining relationships between records.

Additional identifying attributes may include registered names, alternate names, previous names, website domains, national business registration identifiers, and public company identifiers. These identifiers serve different purposes and may not be available for every organization. For example, securities identifiers such as CIK, ISIN, and CUSIP should not automatically be treated as interchangeable company identifiers.

For details about retired IDs, duplicate records, and organizational changes, see the Lightcast Companies FAQ.

3. Organizational Hierarchies

Lightcast Companies represents organizational relationships using company roles and parent identifiers. The primary roles are headquarters, subsidiary, branch, standalone, and holding company.

Three key fields describe a company's position within the hierarchy:

Field

Description

role

The organization's role within the Lightcast hierarchy

immediate_parent_id

The company directly above the record

ultimate_parent_id

The highest operating company within the relevant hierarchy

The hierarchy is designed to reflect how organizations operate in the labor market rather than reproduce a complete legal ownership structure.

For example, a holding company may own an operating company and several subsidiaries. The operating company may be designated as the operational ultimate parent, even though the holding company is the highest legal owner.

Where an organization does not roll up to another operating company, its immediate and ultimate parent fields may reference its own company information.

Interpreting Employee Counts and Revenue

Company revenue and employee counts represent the organization together with entities beneath it in the Lightcast hierarchy.

For a global headquarters, this generally means the broader corporate group. For a subsidiary, the values include that subsidiary and its associated branches or other downstream entities.

These figures may be based on company disclosures, third-party information, or estimates, depending on availability.

Parent and subsidiary figures may overlap. Summing revenue or employee counts across related company records can therefore result in double counting.

Interpreting the Number of Offices

The number_of_offices field represents the number of organization records linked beneath a company in the hierarchy, including the company itself.

It should not be interpreted as a verified count of distinct physical business locations. A single company record may represent a broader operating entity, while some physical locations may not be represented individually.

4. Industry Coding

Lightcast Companies primarily uses the six-digit US North American Industry Classification System (NAICS 2022) based on an organization’s business activities.

The database provides primary industry codes at two-, three-, and six-digit levels. Additional fields may include secondary and tertiary NAICS codes.

For companies in the United Kingdom, Singapore, Australia, and New Zealand, Lightcast also supports the respective national industry classification systems, including UK SIC, Singapore SSIC, and ANZSIC.

Not every company has a populated industry code. Where available information does not support a detailed code, a broader industry category may be used or the field may remain unpopulated. Industry codes are continuously improved and backfilled as additional company information becomes available.

Customers should consult the Lightcast Companies Data Dictionary for the available industry fields and classification versions.

5. Company Attributes and Data Completeness

Lightcast Companies provides a range of attributes to support company identification, segmentation, and analysis.

Attribute category

Examples

Company identity

Company name, registered name, alternate names, previous name, identifiers

Firmographics

Employee count, revenue, founding year, business characteristics

Geography

Address, city, postal code, country, administrative areas, coordinates

Industry

Primary, secondary, and additional industry classifications

Organizational relationships

Company role, immediate parent, ultimate parent, holding-company relationships

Public company information

Stock ticker, exchange, securities identifiers

Record metadata

Creation date, last update date, version, completeness indicators

Geographic Information

Company geographic attributes generally describe the organization's primary physical address.

The address field contains the street address as a combined value rather than separate address lines. Other available fields provide city, postal code, country, administrative area, and geographic coordinates.

Geographic information should not automatically be interpreted as a complete list of the organization's operating locations or as confirmation of its registered legal address.

Attribute Completeness

Not all attributes are populated for every company. Publicly traded organizations generally disclose more financial and organizational information than private businesses. Smaller companies and organizations in markets with less accessible business information may therefore have fewer populated attributes.

Company identification and firmographic enrichment are also separate processes. An organization may be identifiable through its name, website, or other attributes without having a reliable city, employee count, or revenue figure.

A missing value indicates that information is not provided for that attribute. It should not automatically be interpreted as zero or as evidence that the attribute does not apply.

For complete field names, data types, and definitions, see the Lightcast Companies Data Dictionary.

6. Data Sources and Ongoing Data Improvements

Lightcast Companies combines information from multiple third-party data providers, Lightcast's own data sources, and manual research and curation.

Data processing includes company standardization, entity resolution, enrichment, and automated and manual ongoing data improvements.

These processes help identify organizations consistently, reduce duplicate records, improve attribute completeness, and maintain organizational relationships. Lightcast also conducts targeted quarterly reviews of high-priority companies, including major employers and publicly traded organizations, on a rolling basis.

Data quality is an ongoing process, with improvements incorporated as additional information becomes available and existing records are reviewed.

7. Refreshes and Historical Information

Lightcast Companies is refreshed every four weeks. Updates may include new organizations, changes to company attributes, hierarchy updates, address corrections, and data-quality improvements. Not every company record changes during each release.

Record dates and Versions

The following fields help customers interpret record changes and database versions:

Field

Description

created_date

Date the organization record was created

last_update_date

Date a field within the company record was last changed

version

Database release version

is_latest_version

Indicates whether the record belongs to the latest release

company_previous_name

Most recent previous company name

The last_update_date field indicates a change to the record, not necessarily when every underlying attribute was independently verified.

Historical Releases

Starting in 2027, Lightcast plans to retain the latest release and two previous release snapshots on a rolling basis. This will allow customers to compare company information across recent releases using the version and is_latest_version fields.

The company_previous_name field stores only the most recent previous company name, rather than a complete history of name changes. A planned stock listing reference table will provide additional historical information about publicly traded companies, including delisted organizations and previous stock ticker symbols.

These capabilities support historical continuity but are not intended to provide a complete audit trail of every company attribute or organizational change.

8. Accessing Lightcast Companies

Lightcast Companies is available through supported delivery methods, including the Snowflake Data Share and Lightcast Company API.

Snowflake Data Share

The Companies Data Share provides direct access to company tables and views for analysis and integration.

The primary company view is: LIGHTCAST.COMPANIES.COMPANIES

For field definitions, data types, and technical details, see the Lightcast Companies Data Dictionary.

Lightcast Company API

The Lightcast Company API provides programmatic access to supported company information. Available attributes, response structures, and functionality may differ from the Snowflake Data Share, see API Reference. Customers should consult the relevant API reference for supported endpoints and fields.

9. Related Documentation

Core Documentation

Migration and Release Information

For data questions or to report potential issues, contact [email protected]

Did this answer your question?