> ## Documentation Index
> Fetch the complete documentation index at: https://dev.kernel.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Firmographic result

This object is returned in the `record` field when you call [Get firmographics](/api-reference/endpoint/get-firmographics) or poll a completed [enrichment job](/api-reference/endpoint/get-firmographics-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

```json Full result theme={null}
{
  "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"
  }
}
```

```json Partial result — inner fields null theme={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.