record field when you call Get firmographics or poll a completed enrichment job.
The result contains five groups of firmographic data, each always present as an object. Individual fields within each group may be null when the value is estimated or unavailable. It also carries parent and top parent fields.
Top-level fields
kernel_id
string — The unique identifier for the entity in Kernel’s database. Same kernel_id returned by entity resolution.
op_status
object — Operational status of the entity.
Contains:
location
object — Operating and registered addresses.
Contains:
Each
Address contains:
headcount
object — Headcount data for the entity.
Use count for the recommended headline figure; count_entity and count_consolidated expose the underlying entity-direct and consolidated figures.
Contains:
revenue
object — Revenue data for the entity.
Mirrors the headcount structure: the top-level usd / local / local_currency fields hold the recommended figure, while *_entity and consolidated_* expose the underlying entity-direct and consolidated figures.
Contains:
industry
object — Industry classification under three standards.
Contains:
Each
Standard contains:
Each
Level contains:
Kernel classifies to the deepest level the evidence supports and fills the levels above it. When the evidence supports only a higher level, the lower levels are
null. When it supports none, every level and reasoning are null. reasoning can also be null on a classified standard when no explanation meets the reasoning rules.
If an activity fits no top-level category of a standard, its top level is { "value": "Other", "code": null, "label": "Other" }, every lower level is null, and reasoning explains why. This is the only case where code is null.
Parent and top parent fields
The result also carries flatparent_* and top_parent_* fields. They give the firmographics of the entity’s immediate parent and top (ultimate) parent, so you get group context without a second lookup. The entity’s own figures stay in headcount and revenue.
Each prefix carries the same fields, read from that ancestor:
Revenue and headcount are the ancestor’s recommended figures. Kernel uses the consolidated figure for an entity that heads a group, so
top_parent_kernel_revenue_effective_usd and top_parent_kernel_headcount_effective usually give whole-group totals.
When the entity has no parent or top parent, every field under that prefix is null. A field is also null when the ancestor has no value for it. Values reflect the hierarchy at the time you fetch the result, so they change when the parent changes.
For a top-level entity, the top_parent_* fields may describe the entity itself.
Subsidiary with group context
Examples
Full result
Partial result — inner fields null
count, usd, reasoning, and confidence may be null when the data is unavailable or not yet determined.