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 independently nullable. A group is null when that attribute has not yet been determined — it does not mean the value is zero or empty.

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 | null — 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 | null — Operating and registered addresses. Contains:

Field	Type	Description
`operating`	`Address \| null`	Primary operating address
`registered`	`Address \| null`	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 | null — Headcount data for the entity. Contains:

Field	Type	Description
`count`	`number \| null`	Entity-level headcount
`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 | null — Revenue data for the entity. Contains:

Field	Type	Description
`usd`	`number \| null`	Entity-level annual revenue in USD
`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`	The local currency of the entity-level source figure, before USD conversion
`consolidated_local`	`number \| null`	Consolidated revenue in local currency
`consolidated_currency`	`string \| null`	The currency of the consolidated source figure, before USD conversion
`local`	`number \| null`	Entity-level annual revenue in local currency
`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_consolidated": 13307,
    "confidence": "HIGH",
    "reasoning": "Headcount derived from annual report figures."
  },
  "revenue": {
    "usd": 2613846573,
    "consolidated_usd": 2613846573,
    "confidence": "HIGH",
    "local_currency": "INR",
    "consolidated_local": 217820547750,
    "consolidated_currency": "INR",
    "local": 217820547750,
    "reasoning": "Revenue sourced from audited annual financial statements.",
    "source": "identified"
  }
}

Partial result — some groups 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_consolidated": 8150,
    "confidence": null,
    "reasoning": null
  },
  "revenue": null
}

null groups indicate that enrichment has not yet been run for that attribute.

​Top-level fields

​kernel_id

​op_status

​location

​headcount

​revenue

​Examples