Skip to main content
Resolve a company to its canonical entity and retrieve firmographic data using the Kernel API. You’ll make three API calls: one to start the job, one to get the identity result, and one to get firmographic data.

​
Prerequisites

​
1. Start entity resolution

Send a POST request with a company name:
curl
curl -X POST https://api.kernel.ai/rest/v1/entity-resolution \
  -H "x-api-key: $KERNEL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"legal_name": "Stripe"}'
You’ll receive a 202 with a job ID:
Response (202)
{
  "jobId": "550e8400-e29b-41d4-a716-446655440000",
  "status": "processing"
}

​
2. Get the result

Poll the job endpoint with the jobId from step 1:
curl
curl https://api.kernel.ai/rest/v1/entity-resolution/550e8400-e29b-41d4-a716-446655440000 \
  -H "x-api-key: $KERNEL_API_KEY"
When the job is complete, you’ll get the resolved identity:
Response (200)
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "completed",
  "created_at": "2025-06-05T12:00:00Z",
  "completed_at": "2025-06-05T12:00:05Z",
  "record": {
    "kernel_id": "6347422643",
    "entity_type": "legal_entity",
    "entity_resolution_confidence": "HIGH",
    "entity_resolution_reasoning": "Company identified as Stripe, Inc. via legal name, website, and country alignment.",
    "legal_info": {
      "country": "US",
      "reasoning": "Confirmed via terms of service page.",
      "brand_name": "Stripe, Inc.",
      "confidence": "HIGH",
      "legal_name": "Stripe, Inc.",
      "website": "https://stripe.com"
    },
    "brand_info": {
      "country": "US",
      "website": "https://stripe.com",
      "reasoning": "Primary brand site confirmed via domain ownership.",
      "brand_name": "Stripe",
      "confidence": "HIGH"
    },
    "entity_classification": {
      "type": "Company",
      "subtype": "Operating",
      "reasoning": "Classified as an operating company based on commercial activity."
    }
  }
}

​
3. Get firmographic data

Use the kernel_id from the resolved entity to retrieve firmographic data:
curl
curl https://api.kernel.ai/rest/v1/firmographics/6347422643 \
  -H "x-api-key: $KERNEL_API_KEY"
Response (200)
{
  "kernel_id": "6347422643",
  "op_status": {
    "operational_status": "Active",
    "reasoning": "Entity is actively operating."
  },
  "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": "HIGH",
    "reasoning": null
  },
  "revenue": null
}
Firmographic groups that return null have not yet been enriched. Use the enrichment job endpoint to trigger enrichment and poll for results.

​
Next steps

API reference

Full endpoint documentation, authentication, and error handling.

Firmographic result

Full schema for the firmographic response object.