> ## 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.

# Get combined result

> Returns the status and result of a combined job. When `status` is `completed`, the `record` object contains the entity resolution result and the requested enrichment.

Returns the status and result of a combined job started with [`POST /v1/combined`](/api-reference/endpoint/combined).

When `status` is `completed`, the `record` field contains:

* The entity resolution result (`kernel_id`, `identity_resolution_*`, `legal_info`, `trading_info`, `entity_classification`, and optionally `linkedin`)
* The follow-up enrichment result under `firmographics` or `parentage`, depending on the `jobs` value submitted
* Your `external_id`, echoed back on `record.external_id`, if you included one in the request

If entity resolution does not find a match, the job still completes: `record.kernel_id` is `null`, the identity detail fields and any requested follow-up fields are `null`, and `identity_resolution_confidence` and `identity_resolution_reasoning` explain the resolution attempt. See [No match](#no-match).

## Processing response

While the combined job is running, the response includes a `subprocesses` object showing the status of each step:

```json theme={null}
{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "status": "processing",
  "created_at": "2025-06-05T12:00:00Z",
  "subprocesses": {
    "entity-resolution": "completed",
    "resolve-parent": "processing",
    "firmographics": "pending"
  }
}
```

Each subprocess follows the same `pending → processing → completed | failed` lifecycle. Poll until the top-level `status` is `completed` or `failed`.

## Completed response examples

### With firmographics

```json theme={null}
{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "status": "completed",
  "created_at": "2025-06-05T12:00:00Z",
  "completed_at": "2025-06-05T12:00:05Z",
  "record": {
    "kernel_id": "6347422643",
    "identity_type": "legal_entity",
    "identity_resolution_confidence": "HIGH",
    "identity_resolution_reasoning": "Matched by domain and legal name.",
    "legal_info": {
      "country": "US",
      "reasoning": "Confirmed via Stripe terms of service page.",
      "trading_name": "Stripe, Inc.",
      "confidence": "HIGH",
      "legal_name": "Stripe, Inc.",
      "website": "https://stripe.com"
    },
    "trading_info": {
      "country": "US",
      "website": "https://stripe.com",
      "reasoning": "Primary brand site confirmed via domain ownership.",
      "trading_name": "Stripe",
      "confidence": "HIGH"
    },
    "entity_classification": {
      "type": "Company",
      "subtype": "Operating",
      "reasoning": "Classified as an operating company based on commercial activity."
    },
    "firmographics": {
      "kernel_id": "6347422643",
      "op_status": {
        "operational_status": "Active",
        "reasoning": "Website is live."
      },
      "location": {
        "operating": {
          "city": "South San Francisco",
          "country": "US"
        }
      },
      "headcount": {
        "count": 7000
      },
      "revenue": {
        "usd": 1000000000
      }
    },
    "external_id": "stripe-001"
  }
}
```

### With parentage

```json theme={null}
{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "status": "completed",
  "created_at": "2025-06-05T12:00:00Z",
  "completed_at": "2025-06-05T12:00:05Z",
  "record": {
    "kernel_id": "6347422643",
    "identity_type": "legal_entity",
    "identity_resolution_confidence": "HIGH",
    "identity_resolution_reasoning": "Matched by domain and legal name.",
    "legal_info": {
      "country": "US",
      "reasoning": "Confirmed via Stripe terms of service page.",
      "trading_name": "Stripe, Inc.",
      "confidence": "HIGH",
      "legal_name": "Stripe, Inc.",
      "website": "https://stripe.com"
    },
    "trading_info": {
      "country": "US",
      "website": "https://stripe.com",
      "reasoning": "Primary brand site confirmed via domain ownership.",
      "trading_name": "Stripe",
      "confidence": "HIGH"
    },
    "entity_classification": {
      "type": "Company",
      "subtype": "Operating",
      "reasoning": "Classified as an operating company based on commercial activity."
    },
    "parentage": {
      "kernel_id": "6347422643",
      "parent": null,
      "top_parent": {
        "kernel_id": "6347422643",
        "trading_name": "Stripe",
        "legal_name": "Stripe, Inc.",
        "website": "https://stripe.com",
        "country": "US",
        "entity_category": "Company",
        "entity_sub_category": "Operating",
        "confidence": null
      },
      "top_operating_parent": {
        "kernel_id": "6347422643",
        "trading_name": "Stripe",
        "legal_name": "Stripe, Inc.",
        "website": "https://stripe.com",
        "country": "US",
        "entity_category": "Company",
        "entity_sub_category": "Operating",
        "confidence": null
      },
      "regional_subsidiary": {
        "is_regional": false,
        "regional_scope": null,
        "reasoning": null
      }
    }
  }
}
```

### With firmographics and parentage

```json theme={null}
{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "status": "completed",
  "created_at": "2025-06-05T12:00:00Z",
  "completed_at": "2025-06-05T12:00:05Z",
  "record": {
    "kernel_id": "6347422643",
    "identity_type": "legal_entity",
    "identity_resolution_confidence": "HIGH",
    "identity_resolution_reasoning": "Matched by domain and legal name.",
    "legal_info": {
      "country": "US",
      "reasoning": "Confirmed via Stripe terms of service page.",
      "trading_name": "Stripe, Inc.",
      "confidence": "HIGH",
      "legal_name": "Stripe, Inc.",
      "website": "https://stripe.com"
    },
    "trading_info": {
      "country": "US",
      "website": "https://stripe.com",
      "reasoning": "Primary brand site confirmed via domain ownership.",
      "trading_name": "Stripe",
      "confidence": "HIGH"
    },
    "entity_classification": {
      "type": "Company",
      "subtype": "Operating",
      "reasoning": "Classified as an operating company based on commercial activity."
    },
    "firmographics": {
      "kernel_id": "6347422643",
      "op_status": {
        "operational_status": "Active",
        "reasoning": "Website is live."
      },
      "location": {
        "operating": {
          "street": null,
          "city": "South San Francisco",
          "state": "California",
          "country": "United States",
          "postcode": "94080",
          "reasoning": "Address derived from company registration records."
        },
        "registered": {
          "street": "354 Oyster Point Blvd",
          "city": "South San Francisco",
          "state": "California",
          "country": "United States",
          "postcode": "94080",
          "reasoning": "Address from official registry filing."
        }
      },
      "headcount": {
        "count": 7000,
        "count_entity": 7000,
        "count_consolidated": 7000,
        "confidence": "HIGH",
        "reasoning": "Headcount derived from annual report figures."
      },
      "revenue": {
        "usd": 1000000000,
        "usd_entity": 1000000000,
        "consolidated_usd": 1000000000,
        "confidence": "HIGH",
        "local_currency": "USD",
        "local_currency_entity": "USD",
        "local": 1000000000,
        "local_entity": 1000000000,
        "consolidated_local": 1000000000,
        "consolidated_currency": "USD",
        "reasoning": "Revenue sourced from audited annual financial statements.",
        "source": "identified"
      }
    },
    "parentage": {
      "kernel_id": "6347422643",
      "parent": null,
      "top_parent": {
        "kernel_id": "6347422643",
        "trading_name": "Stripe",
        "legal_name": "Stripe, Inc.",
        "website": "https://stripe.com",
        "country": "US",
        "entity_category": "Company",
        "entity_sub_category": "Operating",
        "confidence": null
      },
      "top_operating_parent": {
        "kernel_id": "6347422643",
        "trading_name": "Stripe",
        "legal_name": "Stripe, Inc.",
        "website": "https://stripe.com",
        "country": "US",
        "entity_category": "Company",
        "entity_sub_category": "Operating",
        "confidence": null
      },
      "regional_subsidiary": {
        "is_regional": false,
        "regional_scope": null,
        "reasoning": null
      }
    }
  }
}
```

## No match

If entity resolution does not find a match, the follow-up credits are refunded, the follow-up jobs are skipped, and the job completes with `kernel_id: null`. The requested follow-up fields (`firmographics`, `parentage`) are returned as `null`, along with `linkedin` if `match_to_linkedin` was requested. `identity_resolution_confidence` and `identity_resolution_reasoning` remain populated to explain the resolution attempt:

```json theme={null}
{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "status": "completed",
  "created_at": "2025-06-05T12:00:00Z",
  "completed_at": "2025-06-05T12:00:05Z",
  "record": {
    "kernel_id": null,
    "identity_resolution_confidence": "HIGH",
    "identity_resolution_reasoning": "Company identified as Acme Inc. via legal name and website alignment, but no matching entity exists in Kernel's database.",
    "legal_info": null,
    "trading_info": null,
    "entity_classification": null,
    "firmographics": null,
    "parentage": null
  }
}
```

## Failed response

If the job fails for another reason, the response uses `jobid` instead of `id` and includes `error_message` and `error_type`:

```json theme={null}
{
  "jobid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "status": "failed",
  "error_message": "Job failed",
  "error_type": "unknown"
}
```


## OpenAPI

````yaml GET /v1/combined/{job_id}
openapi: 3.1.0
info:
  title: Kernel API
  description: Resolve company identities to canonical entities with a simple async API
  version: 1.0.0
  contact:
    email: support@kernel.ai
  license:
    name: MIT
servers:
  - url: https://api.kernel.ai/rest
    description: Production
security:
  - apiKeyAuth: []
tags:
  - name: Entity Resolution
    description: Resolve a company to a canonical entity
  - name: Firmographics
    description: Retrieve and enrich firmographic data for resolved entities
  - name: Parentage
    description: Look up parent and top-parent entities in a corporate hierarchy
  - name: Combined
    description: Resolve an entity and run a follow-up enrichment in one call
  - name: LinkedIn Lookup
    description: Provisional LinkedIn company match jobs (not Kernel-verified)
paths:
  /v1/combined/{job_id}:
    get:
      tags:
        - Combined
      summary: Get combined result
      description: >-
        Returns the status and result of a combined job. When `status` is
        `completed`, the `record` object contains the entity resolution result
        and the requested enrichment.
      operationId: getCombined
      parameters:
        - name: job_id
          in: path
          description: Job ID returned by the POST endpoint
          required: true
          schema:
            type: string
            example: a1b2c3d4-e5f6-7890-abcd-ef1234567890
      responses:
        '200':
          description: Job status response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CombinedJobStatus'
              examples:
                completed_firmographics:
                  summary: Completed with firmographics
                  value:
                    id: a1b2c3d4-e5f6-7890-abcd-ef1234567890
                    status: completed
                    created_at: '2025-06-05T12:00:00Z'
                    completed_at: '2025-06-05T12:00:05Z'
                    record:
                      kernel_id: '6347422643'
                      identity_type: legal_entity
                      identity_resolution_confidence: HIGH
                      identity_resolution_reasoning: Matched by domain and legal name.
                      legal_info:
                        country: US
                        reasoning: Confirmed via Stripe terms of service page.
                        trading_name: Stripe, Inc.
                        confidence: HIGH
                        legal_name: Stripe, Inc.
                        website: https://stripe.com
                      trading_info:
                        country: US
                        website: https://stripe.com
                        reasoning: Primary brand site confirmed via domain ownership.
                        trading_name: Stripe
                        confidence: HIGH
                      entity_classification:
                        type: Company
                        subtype: Operating
                        reasoning: >-
                          Classified as an operating company based on commercial
                          activity.
                      firmographics:
                        kernel_id: '6347422643'
                        op_status:
                          operational_status: Active
                          reasoning: Website is live.
                        location:
                          operating:
                            city: South San Francisco
                            country: US
                        headcount:
                          count: 7000
                        revenue:
                          usd: 1000000000
                completed_parentage:
                  summary: Completed with parentage
                  value:
                    id: a1b2c3d4-e5f6-7890-abcd-ef1234567890
                    status: completed
                    created_at: '2025-06-05T12:00:00Z'
                    completed_at: '2025-06-05T12:00:05Z'
                    record:
                      kernel_id: '6347422643'
                      identity_type: legal_entity
                      identity_resolution_confidence: HIGH
                      identity_resolution_reasoning: Matched by domain and legal name.
                      legal_info:
                        country: US
                        reasoning: Confirmed via Stripe terms of service page.
                        trading_name: Stripe, Inc.
                        confidence: HIGH
                        legal_name: Stripe, Inc.
                        website: https://stripe.com
                      trading_info:
                        country: US
                        website: https://stripe.com
                        reasoning: Primary brand site confirmed via domain ownership.
                        trading_name: Stripe
                        confidence: HIGH
                      entity_classification:
                        type: Company
                        subtype: Operating
                        reasoning: >-
                          Classified as an operating company based on commercial
                          activity.
                      parentage:
                        kernel_id: '6347422643'
                        parent: null
                        top_parent:
                          kernel_id: '6347422643'
                          trading_name: Stripe
                          legal_name: Stripe, Inc.
                          website: https://stripe.com
                          country: US
                          entity_category: Company
                          entity_sub_category: Operating
                          confidence: null
                        top_operating_parent:
                          kernel_id: '6347422643'
                          trading_name: Stripe
                          legal_name: Stripe, Inc.
                          website: https://stripe.com
                          country: US
                          entity_category: Company
                          entity_sub_category: Operating
                          confidence: null
                        regional_subsidiary:
                          is_regional: false
                          regional_scope: null
                          reasoning: null
                completed_full_bundle:
                  summary: Completed with firmographics and parentage
                  value:
                    id: a1b2c3d4-e5f6-7890-abcd-ef1234567890
                    status: completed
                    created_at: '2025-06-05T12:00:00Z'
                    completed_at: '2025-06-05T12:00:05Z'
                    record:
                      kernel_id: '6347422643'
                      identity_type: legal_entity
                      identity_resolution_confidence: HIGH
                      identity_resolution_reasoning: Matched by domain and legal name.
                      legal_info:
                        country: US
                        reasoning: Confirmed via Stripe terms of service page.
                        trading_name: Stripe, Inc.
                        confidence: HIGH
                        legal_name: Stripe, Inc.
                        website: https://stripe.com
                      trading_info:
                        country: US
                        website: https://stripe.com
                        reasoning: Primary brand site confirmed via domain ownership.
                        trading_name: Stripe
                        confidence: HIGH
                      entity_classification:
                        type: Company
                        subtype: Operating
                        reasoning: >-
                          Classified as an operating company based on commercial
                          activity.
                      firmographics:
                        kernel_id: '6347422643'
                        op_status:
                          operational_status: Active
                          reasoning: Website is live.
                        location:
                          operating:
                            street: null
                            city: South San Francisco
                            state: California
                            country: United States
                            postcode: '94080'
                            reasoning: Address derived from company registration records.
                          registered:
                            street: 354 Oyster Point Blvd
                            city: South San Francisco
                            state: California
                            country: United States
                            postcode: '94080'
                            reasoning: Address from official registry filing.
                        headcount:
                          count: 7000
                          count_entity: 7000
                          count_consolidated: 7000
                          confidence: HIGH
                          reasoning: Headcount derived from annual report figures.
                        revenue:
                          usd: 1000000000
                          usd_entity: 1000000000
                          consolidated_usd: 1000000000
                          confidence: HIGH
                          local_currency: USD
                          local_currency_entity: USD
                          local: 1000000000
                          local_entity: 1000000000
                          consolidated_local: 1000000000
                          consolidated_currency: USD
                          reasoning: >-
                            Revenue sourced from audited annual financial
                            statements.
                          source: identified
                      parentage:
                        kernel_id: '6347422643'
                        parent: null
                        top_parent:
                          kernel_id: '6347422643'
                          trading_name: Stripe
                          legal_name: Stripe, Inc.
                          website: https://stripe.com
                          country: US
                          entity_category: Company
                          entity_sub_category: Operating
                          confidence: null
                        top_operating_parent:
                          kernel_id: '6347422643'
                          trading_name: Stripe
                          legal_name: Stripe, Inc.
                          website: https://stripe.com
                          country: US
                          entity_category: Company
                          entity_sub_category: Operating
                          confidence: null
                        regional_subsidiary:
                          is_regional: false
                          regional_scope: null
                          reasoning: null
                completed_no_match:
                  summary: Completed — no match found
                  value:
                    id: a1b2c3d4-e5f6-7890-abcd-ef1234567890
                    status: completed
                    created_at: '2025-06-05T12:00:00Z'
                    completed_at: '2025-06-05T12:00:05Z'
                    record:
                      kernel_id: null
                      identity_resolution_confidence: HIGH
                      identity_resolution_reasoning: >-
                        Company identified as Acme Inc. via legal name and
                        website alignment, but no matching entity exists in
                        Kernel's database.
                      legal_info: null
                      trading_info: null
                      entity_classification: null
                      firmographics: null
                      parentage: null
                processing:
                  summary: Still processing
                  value:
                    id: a1b2c3d4-e5f6-7890-abcd-ef1234567890
                    status: processing
                    created_at: '2025-06-05T12:00:00Z'
                pending:
                  summary: Unknown or not yet created
                  value:
                    status: pending
                failed:
                  summary: Failed
                  value:
                    jobid: a1b2c3d4-e5f6-7890-abcd-ef1234567890
                    status: failed
                    error_message: Job failed
                    error_type: unknown
        '403':
          description: Forbidden — missing or invalid API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ForbiddenError'
              example:
                message: Forbidden
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                error: Service unavailable
components:
  schemas:
    CombinedJobStatus:
      type: object
      required:
        - status
      properties:
        id:
          description: >-
            Unique identifier for the job. Present when `status` is `pending`,
            `processing`, or `completed`.
          type: string
          example: a1b2c3d4-e5f6-7890-abcd-ef1234567890
        jobid:
          description: >-
            Unique identifier for the job. Present only when `status` is
            `failed`.
          type: string
          example: a1b2c3d4-e5f6-7890-abcd-ef1234567890
        status:
          description: >-
            Current status of the job. Terminal states are `completed` and
            `failed`.
          type: string
          enum:
            - pending
            - processing
            - completed
            - failed
        created_at:
          description: ISO 8601 timestamp when the job was created.
          type: string
          format: date-time
          example: '2025-06-05T12:00:00Z'
        completed_at:
          description: ISO 8601 timestamp when the job reached a terminal state.
          type: string
          format: date-time
          example: '2025-06-05T12:00:05Z'
        record:
          $ref: '#/components/schemas/CombinedResult'
          description: >-
            Combined entity resolution and enrichment result. Present when
            `status` is `completed`.
        error_message:
          description: Error message. Present when `status` is `failed`.
          type: string
        error_type:
          description: >-
            Machine-readable error type. Present when `status` is `failed`. One
            of: `kernel_id_not_found`, `unknown`.
          type: string
    ForbiddenError:
      required:
        - message
      type: object
      properties:
        message:
          description: Error message from API Gateway.
          type: string
          example: Forbidden
    Error:
      required:
        - error
      type: object
      properties:
        error:
          description: Error description.
          type: string
          example: Entity not found
    CombinedResult:
      type: object
      required:
        - kernel_id
        - identity_resolution_confidence
        - identity_resolution_reasoning
        - legal_info
        - trading_info
        - entity_classification
      properties:
        kernel_id:
          description: >-
            The unique identifier for the resolved entity in Kernel's database.
            `null` when no entity is resolved.
          type:
            - string
            - 'null'
          example: '6347422643'
        identity_type:
          description: Type of identity resolved.
          type: string
          enum:
            - legal_entity
            - trading_entity
          example: legal_entity
        identity_resolution_confidence:
          description: Confidence that the resolved identity is correct.
          type: string
          enum:
            - HIGH
            - MEDIUM
            - LOW
        identity_resolution_reasoning:
          description: Explanation of how the identity was resolved.
          type: string
        legal_info:
          description: Legal entity information. `null` when no entity is resolved.
          oneOf:
            - type: 'null'
            - $ref: '#/components/schemas/LegalInfo'
        trading_info:
          description: Trading entity information. `null` when no entity is resolved.
          oneOf:
            - type: 'null'
            - $ref: '#/components/schemas/TradingInfo'
        entity_classification:
          description: Classification of the entity. `null` when no entity is resolved.
          oneOf:
            - type: 'null'
            - $ref: '#/components/schemas/EntityClassification'
        linkedin:
          description: >-
            LinkedIn profile match. Only present when `match_to_linkedin` is
            true. `null` when entity resolution found no match.
          oneOf:
            - type: 'null'
            - 7c14dd7d-c8c2-46b6-a941-5b22bf259bc6
        firmographics:
          description: >-
            Firmographic enrichment result. Present when `jobs` includes
            `firmographics`. `null` when entity resolution found no match.
          oneOf:
            - type: 'null'
            - $ref: '#/components/schemas/FirmographicResult'
        parentage:
          description: >-
            Parentage result. Present when `jobs` includes `resolve-parent`.
            `null` when entity resolution found no match.
          oneOf:
            - type: 'null'
            - $ref: '#/components/schemas/ResolveParentResponse'
        external_id:
          description: >-
            Echoed back from your request. Present only when you included an
            `external_id` in the submitted record. Use it to correlate this
            result with the record you sent.
          type: string
          example: stripe-001
    LegalInfo:
      type: object
      required:
        - country
        - reasoning
        - trading_name
        - confidence
        - legal_name
        - website
      properties:
        country:
          description: Country of the legal entity.
          type:
            - string
            - 'null'
          example: US
        reasoning:
          description: Explanation of how the legal entity was identified.
          type: string
          example: Confirmed via Stripe terms of service page.
        trading_name:
          description: Trading name associated with the legal entity.
          type:
            - string
            - 'null'
          example: Stripe, Inc.
        confidence:
          description: Confidence in the legal entity info.
          type: string
          enum:
            - HIGH
            - MEDIUM
            - LOW
        legal_name:
          description: Registered legal name.
          type:
            - string
            - 'null'
          example: Stripe, Inc.
        website:
          description: Official URL of the legal entity.
          type:
            - string
            - 'null'
          example: https://stripe.com
    TradingInfo:
      type: object
      required:
        - country
        - website
        - reasoning
        - trading_name
        - confidence
      properties:
        country:
          description: Country of the trading entity's operational region.
          type:
            - string
            - 'null'
          example: US
        website:
          description: Primary trading website URL.
          type:
            - string
            - 'null'
          example: https://stripe.com
        reasoning:
          description: Explanation of how the trading identity was identified.
          type: string
          example: Primary brand site confirmed via domain ownership.
        trading_name:
          description: Primary trading name.
          type:
            - string
            - 'null'
          example: Stripe
        confidence:
          description: Confidence in the trading identity info.
          type: string
          enum:
            - HIGH
            - MEDIUM
            - LOW
    EntityClassification:
      type: object
      required:
        - type
        - subtype
      properties:
        type:
          description: 'Entity category. One of: Company, Government, Education.'
          type: string
          example: Company
        subtype:
          description: >-
            Entity sub-category. E.g. Operating, HoldCo/Investment, Business
            Unit, Establishment.
          type: string
          example: Operating
        reasoning:
          description: Explanation of the classification.
          type:
            - string
            - 'null'
          example: Classified as an operating company based on commercial activity.
    FirmographicResult:
      required:
        - kernel_id
        - op_status
        - location
        - headcount
        - revenue
      type: object
      properties:
        kernel_id:
          description: The unique identifier for the entity in Kernel's database.
          type: string
          example: '2532551796'
        op_status:
          description: Operational status of the entity. `null` when not yet determined.
          oneOf:
            - type: 'null'
            - type: object
              properties:
                operational_status:
                  description: Current operational status.
                  type:
                    - string
                    - 'null'
                  enum:
                    - Active
                    - Out of business
                    - Absorbed
                    - Undetermined
                    - null
                  example: Active
                reasoning:
                  description: Explanation of how the operational status was determined.
                  type:
                    - string
                    - 'null'
                  example: Entity is actively operating with no signs of cessation.
        location:
          description: Operating and registered addresses. `null` when not yet determined.
          oneOf:
            - type: 'null'
            - type: object
              properties:
                operating:
                  description: Operating address.
                  oneOf:
                    - type: 'null'
                    - $ref: '#/components/schemas/Address'
                registered:
                  description: Registered/legal address.
                  oneOf:
                    - type: 'null'
                    - $ref: '#/components/schemas/Address'
        headcount:
          description: Headcount data. `null` when not yet determined.
          oneOf:
            - type: 'null'
            - type: object
              properties:
                count:
                  description: >-
                    Recommended (headline) headcount. Kernel automatically picks
                    the entity-direct or consolidated figure based on entity
                    type; equals `count_entity` or `count_consolidated`.
                  type:
                    - number
                    - 'null'
                  example: 5300
                count_entity:
                  description: Entity-direct headcount, excluding subsidiaries.
                  type:
                    - number
                    - 'null'
                  example: 5300
                count_consolidated:
                  description: Consolidated headcount including subsidiaries.
                  type:
                    - number
                    - 'null'
                  example: 8150
                confidence:
                  description: Confidence in the headcount figure.
                  type:
                    - string
                    - 'null'
                  enum:
                    - HIGH
                    - MEDIUM
                    - LOW
                    - null
                reasoning:
                  description: Explanation of how the headcount was determined.
                  type:
                    - string
                    - 'null'
                  example: Headcount derived from annual report figures.
        revenue:
          description: Revenue data. `null` when not yet determined.
          oneOf:
            - type: 'null'
            - type: object
              properties:
                usd:
                  description: >-
                    Recommended (headline) annual revenue in USD. Kernel
                    automatically picks the entity-direct or consolidated figure
                    based on entity type; equals `usd_entity` or
                    `consolidated_usd`.
                  type:
                    - number
                    - 'null'
                  example: 16000000000
                usd_entity:
                  description: Entity-direct annual revenue in USD, excluding subsidiaries.
                  type:
                    - number
                    - 'null'
                  example: 16000000000
                consolidated_usd:
                  description: Consolidated annual revenue in USD including subsidiaries.
                  type:
                    - number
                    - 'null'
                  example: 16000000000
                confidence:
                  description: Confidence in the revenue figure.
                  type:
                    - string
                    - 'null'
                  enum:
                    - HIGH
                    - MEDIUM
                    - LOW
                    - null
                local_currency:
                  description: >-
                    The local currency of the recommended source figure, before
                    USD conversion.
                  type:
                    - string
                    - 'null'
                  example: USD
                local_currency_entity:
                  description: >-
                    The local currency of the entity-direct source figure,
                    before USD conversion.
                  type:
                    - string
                    - 'null'
                  example: USD
                local:
                  description: >-
                    Recommended annual revenue in local currency, matching
                    `usd`.
                  type:
                    - number
                    - 'null'
                  example: 16000000000
                local_entity:
                  description: Entity-direct annual revenue in local currency.
                  type:
                    - number
                    - 'null'
                  example: 16000000000
                consolidated_local:
                  description: Consolidated revenue in local currency.
                  type:
                    - number
                    - 'null'
                  example: 16000000000
                consolidated_currency:
                  description: >-
                    The currency of the consolidated source figure, before USD
                    conversion.
                  type:
                    - string
                    - 'null'
                  example: USD
                reasoning:
                  description: Explanation of how the revenue figure was determined.
                  type:
                    - string
                    - 'null'
                  example: Revenue sourced from audited annual financial statements.
                source:
                  description: >-
                    Source of the revenue data. One of: `identified`,
                    `estimated`.
                  type:
                    - string
                    - 'null'
                  enum:
                    - identified
                    - estimated
                    - null
                  example: identified
    ResolveParentResponse:
      type: object
      required:
        - kernel_id
        - regional_subsidiary
      properties:
        kernel_id:
          description: The kernel_id of the queried entity.
          type: string
          example: '6347422643'
        parent:
          description: >-
            The immediate parent entity. `null` when the entity has no parent
            (standalone).
          oneOf:
            - type: 'null'
            - $ref: '#/components/schemas/ParentEntity'
        top_parent:
          description: >-
            The ultimate parent entity at the top of the corporate hierarchy.
            For standalone entities, top_parent points to the entity itself and
            parent is null.
          oneOf:
            - type: 'null'
            - $ref: '#/components/schemas/ParentEntity'
        top_operating_parent:
          description: >-
            The top operating parent entity in the corporate hierarchy,
            excluding HoldCo/investment vehicles. `null` when the entity is
            standalone or has no operating parent.
          oneOf:
            - type: 'null'
            - $ref: '#/components/schemas/ParentEntity'
        regional_subsidiary:
          $ref: '#/components/schemas/RegionalSubsidiary'
          description: Whether the entity operates as a regional subsidiary of its parent.
    Address:
      type: object
      properties:
        street:
          description: Street address.
          type:
            - string
            - 'null'
          example: 354 Oyster Point Blvd
        city:
          description: City.
          type:
            - string
            - 'null'
          example: South San Francisco
        state:
          description: State or province.
          type:
            - string
            - 'null'
          example: California
        country:
          description: Country.
          type:
            - string
            - 'null'
          example: United States
        postcode:
          description: ZIP or postal code.
          type:
            - string
            - 'null'
          example: '94080'
        reasoning:
          description: Explanation of how the address was determined.
          type:
            - string
            - 'null'
          example: Address derived from company registration records.
    ParentEntity:
      type: object
      required:
        - kernel_id
      properties:
        kernel_id:
          description: Kernel ID of the parent entity.
          type: string
          example: '7944166432'
        trading_name:
          description: Parent trading name.
          type:
            - string
            - 'null'
          example: Alphabet Inc.
        legal_name:
          description: Parent registered legal name.
          type:
            - string
            - 'null'
          example: Alphabet Inc.
        website:
          description: Parent company website URL.
          type:
            - string
            - 'null'
          example: https://abc.xyz
        country:
          description: Parent country (ISO 3166-1 alpha-2 or full name).
          type:
            - string
            - 'null'
          example: US
        entity_category:
          description: 'Parent entity category. One of: Company, Government, Education.'
          type:
            - string
            - 'null'
          enum:
            - Company
            - Government
            - Education
            - null
        entity_sub_category:
          description: >-
            Parent entity sub-category. E.g. Operating, HoldCo/Investment,
            Business Unit, Establishment.
          type:
            - string
            - 'null'
          example: HoldCo/Investment
        reasoning:
          description: Explanation of why this entity was identified as the parent.
          type:
            - string
            - 'null'
          example: >-
            Google LLC is a wholly-owned subsidiary of Alphabet Inc., its parent
            holding company.
        confidence:
          description: 'Confidence in the parent identification. One of: HIGH, MEDIUM, LOW.'
          type:
            - string
            - 'null'
          enum:
            - HIGH
            - MEDIUM
            - LOW
            - null
    RegionalSubsidiary:
      type: object
      properties:
        is_regional:
          description: >-
            Whether the entity operates as a regional subsidiary. `null` when
            not yet determined.
          type:
            - boolean
            - 'null'
          example: false
        regional_scope:
          description: >-
            The country scope of the regional operation. `null` when not a
            regional subsidiary or not yet determined.
          type:
            - string
            - 'null'
          example: India
        reasoning:
          description: Explanation of the regional subsidiary classification.
          type:
            - string
            - 'null'
          example: Operates as a regional subsidiary focused on the Indian market.
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: Include your API key in the x-api-key header.

````