Firmographic result

This object is returned in the record field when you call Get firmographics or poll a completed enrichment job. The result contains four 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.

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:

Field	Type	Description
`operational_status`	`string \| null`	Current status. One of: `Active`, `Out of business`, `Absorbed`, `Undetermined`
`reasoning`	`string \| null`	Explanation of how the operational status was determined

`location`

object — Operating and registered addresses. Contains:

Field	Type	Description
`operating`	`Address`	Primary operating address
`registered`	`Address`	Registered/legal address

Each Address contains:

Field	Type	Description
`street`	`string \| null`	Street address
`city`	`string \| null`	City
`state`	`string \| null`	State or province
`country`	`string \| null`	Country
`postcode`	`string \| null`	ZIP or postal code
`reasoning`	`string \| null`	Explanation of how the address was determined

`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:

Field	Type	Description
`count`	`number \| null`	Recommended headcount. Kernel automatically picks the entity-direct or consolidated figure based on entity type. Equals `count_entity` or `count_consolidated`.
`count_entity`	`number \| null`	Entity-direct headcount, excluding subsidiaries
`count_consolidated`	`number \| null`	Consolidated headcount including subsidiaries
`confidence`	`string \| null`	Confidence in the figure. One of: `HIGH`, `MEDIUM`, `LOW`
`reasoning`	`string \| null`	Explanation of how the headcount was determined

`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:

Field	Type	Description
`usd`	`number \| null`	Recommended annual revenue in USD. Kernel automatically picks entity-direct or consolidated based on entity type. Equals `usd_entity` or `consolidated_usd`.
`usd_entity`	`number \| null`	Entity-direct annual revenue in USD, excluding subsidiaries
`consolidated_usd`	`number \| null`	Consolidated annual revenue in USD including subsidiaries
`confidence`	`string \| null`	Confidence in the figure. One of: `HIGH`, `MEDIUM`, `LOW`
`local_currency`	`string \| null`	Local currency of the recommended source figure
`local_currency_entity`	`string \| null`	Local currency of the entity-direct source figure
`local`	`number \| null`	Recommended annual revenue in local currency, matching `usd`
`local_entity`	`number \| null`	Entity-direct annual revenue in local currency
`consolidated_local`	`number \| null`	Consolidated revenue in local currency
`consolidated_currency`	`string \| null`	Currency of the consolidated source figure
`reasoning`	`string \| null`	Explanation of how the revenue figure was determined
`source`	`string \| null`	Source of the revenue data. One of: `identified`, `estimated`

Examples

Full result

{
  "kernel_id": "7944166432",
  "op_status": {
    "operational_status": "Active",
    "reasoning": "Entity is actively operating with no signs of cessation or absorption."
  },
  "location": {
    "operating": {
      "street": null,
      "city": "Singrauli",
      "state": "Madhya Pradesh",
      "country": "India",
      "postcode": "486889",
      "reasoning": "Address derived from company registration records."
    },
    "registered": {
      "street": "P.O. Singrauli Colliery",
      "city": "Singrauli",
      "state": "Madhya Pradesh",
      "country": "India",
      "postcode": "486889",
      "reasoning": "Address from official registry filing."
    }
  },
  "headcount": {
    "count": 13307,
    "count_entity": 13307,
    "count_consolidated": 13307,
    "confidence": "HIGH",
    "reasoning": "Headcount derived from annual report figures."
  },
  "revenue": {
    "usd": 2613846573,
    "usd_entity": 2613846573,
    "consolidated_usd": 2613846573,
    "confidence": "HIGH",
    "local_currency": "INR",
    "local_currency_entity": "INR",
    "local": 217820547750,
    "local_entity": 217820547750,
    "consolidated_local": 217820547750,
    "consolidated_currency": "INR",
    "reasoning": "Revenue sourced from audited annual financial statements.",
    "source": "identified"
  }
}

Partial result — inner fields null

{
  "kernel_id": "2532551796",
  "op_status": {
    "operational_status": "Active",
    "reasoning": null
  },
  "location": {
    "operating": {
      "street": "354 Oyster Point Blvd",
      "city": "South San Francisco",
      "state": "California",
      "country": "United States",
      "postcode": null,
      "reasoning": null
    },
    "registered": {
      "street": null,
      "city": null,
      "state": null,
      "country": null,
      "postcode": null,
      "reasoning": null
    }
  },
  "headcount": {
    "count": 5300,
    "count_entity": 5300,
    "count_consolidated": 8150,
    "confidence": null,
    "reasoning": null
  },
  "revenue": {
    "usd": null,
    "consolidated_usd": null,
    "confidence": null,
    "local_currency": null,
    "consolidated_local": null,
    "consolidated_currency": null,
    "local": null,
    "reasoning": null,
    "source": null
  }
}

All four groups are always present as objects. Inner fields like count, usd, reasoning, and confidence may be null when the data is unavailable or not yet determined.

Getting started

API reference

API keys & Webhooks

Firmographic result

Top-level fields

`kernel_id`

`op_status`

`location`

`headcount`

`revenue`

Examples

​Top-level fields

​kernel_id

​op_status

​location

​headcount

​revenue

​Examples

Top-level fields

`kernel_id`

`op_status`

`location`

`headcount`

`revenue`

Examples