All posts
entity-resolutionproduct

SavvyIQ v3: more companies found, industry codes included, half the price

v3 finds the registered company behind a name, including small and international businesses other sources miss, and returns its registration number, identifiers and NAICS industry codes with the evidence behind each. 90% faster and 50% cheaper than v1.

SavvyIQ

· 7 min read

v3 of the SavvyIQ API is live. Send a company name, even a small or obscure one, and get back the registered company, its identifiers and its industry codes, with the evidence behind each.

What you get

You send Cleo AI, London. You get:

Legal companyCLEO AI LTD.
Registered inEngland and Wales, no. 09864205, active
IdentifiersLEI 213800K5HGWYL69PXZ62
IndustryNAICS 513210, Software Publishers (87% confidence)
Websitemeetcleo.com
Where it comes from”CLEO AI LTD., England and Wales registration 09864205, status ACTIVE” (Companies House). Also cited: the UK Open Banking register of regulated providers.

The long tail is where it counts

Finding a household name is easy. The names that cost time are the ones no database has: a five-person supplier in Poland, a vendor in a breach notice, a holding company whose name is written in Japanese. Customers on v3 tell us that is where the difference shows. It finds more small and international businesses than before, and the answers are more accurate.

Cybersecurity and fraud. A domain or a name from a threat report becomes a registered company, with the registry record to prove it. Analysts stop chasing lookalikes, and the obscure vendors that make up most of a supply chain stop coming back as “unknown”.

Fintech, KYB and financial data. A messy list of counterparties becomes registered companies with registration numbers, LEIs and industry codes, each field tied to its source. That is a record an auditor can follow, and fewer names left for someone to research by hand.

What’s new

90% faster. Resolutions finish in a tenth of the time v1 took.

Half the price. Entity Resolution, Business Intelligence and Domain Intelligence are $0.10 a call, 50% less than v1. Status checks are free, and every new account starts with $25 in credit. Full list on /pricing.

Industry codes in every answer. NAICS 2022 codes come back with the match, plus SIC where available, each with a confidence score, so classifying a counterparty no longer needs a second vendor.

More identifiers. Alongside the registration number, v3 returns the identifiers a company has been issued: SEC CIK, LEI, EIN, DUNS, BIC and stock ticker, where they exist.

More on the registration. The record names the register itself (which authority holds it, its jurisdiction, its website), plus the company’s legal form.

Evidence for every field. Add include=basis and each field comes with its sources: the URL, a direct quote from the registry or the web, a confidence, and why it was chosen. Your team can see why a match was made, not just a score.

Non-Latin names. Send 株式会社ソニー with Tokyo, Japan and you get Sony. Names buried in legal text or run together with a tax ID are parsed too. See Handling messy data.

Webhooks. Pass a webhook_url and the result is delivered the moment it is ready, signed per the Standard Webhooks spec. Tag each request with your own custom_id and it comes back on the result.

Also live: Domain Intelligence, which takes a domain or an email address and returns the company behind it.

Try it

curl -X POST "https://api.savvyiq.ai/v3/entity-resolution/async" \
  -H "apikey: YOUR_API_KEY" \
  -H "content-type: application/json" \
  -d '{"name": "Cleo AI", "location": "London, UK", "include": "basis", "custom_id": "blog-cleo"}'

Poll the run_id you get back, or add webhook_url to have the result sent to you. This is the complete response, with the keys ordered for reading: the company first, then why it matched, then the evidence for each field. The Entity Resolution docs explain every field.

{
  "run_id": "run_34WumaVTjY0KBf0Exb6ts",
  "custom_id": "blog-cleo",
  "status": "matched",
  "match_confidence": 98,
  "type": "business",
  "subtype": "incorporated_entity",
  "entity": {
    "id": "siq_34WumvwMPCFzAiW7knCcm",
    "display_name": "Cleo AI",
    "legal_name": "CLEO AI LTD.",
    "status": "active",
    "website": "https://meetcleo.com",
    "description": "Cleo AI develops a money management mobile application and provides AI-powered financial guidance to help users budget, build credit, and manage overdrafts.",
    "headquarters": {
      "address": {
        "street_address": null,
        "street_number": null,
        "sub_premise": null,
        "city": "London",
        "state": "England",
        "state_code": null,
        "postal_code": null,
        "country": "United Kingdom",
        "country_code": "GB",
        "formatted_address": "London, England, United Kingdom"
      }
    },
    "industry": {
      "schemes": {
        "naics_2022": [
          {
            "code": "513210",
            "label": "Software Publishers",
            "confidence": 87,
            "is_primary": true
          },
          {
            "code": "51",
            "label": "Information",
            "confidence": 87,
            "is_primary": false
          }
        ]
      }
    },
    "identifiers": [
      {
        "type": "registration_id",
        "value": "09864205",
        "jurisdiction": "GB"
      },
      {
        "type": "lei",
        "value": "213800K5HGWYL69PXZ62",
        "jurisdiction": null
      }
    ],
    "facets": {
      "sector": "private",
      "legal_form": "corporation"
    },
    "primary_legal_entity": {
      "id": "le_2ZoQFMN4xMHKTBwCPcsJM",
      "state_code": null,
      "country_code": "GB",
      "jurisdiction": "GB",
      "verification": "registry_verified",
      "registration_authority": {
        "id": 1001,
        "code": "RA000585",
        "name": "Companies Register",
        "website": "www.companieshouse.gov.uk",
        "country_code": "GB",
        "jurisdiction": "England and Wales",
        "organization": "Companies House"
      },
      "registered_agent_address": null
    },
    "matching_branch": null
  },
  "factors": [
    {
      "code": "name_close_match",
      "type": "strength",
      "impact": "Supports identification of the correct entity.",
      "description": "'Cleo AI' is the commonly recognized trade name for the registered entity 'CLEO AI LTD.'"
    },
    {
      "code": "headquarters_match",
      "type": "strength",
      "impact": "Confirms this is the primary legal entity location.",
      "description": "The London, UK location matches the confirmed corporate headquarters of the entity."
    },
    {
      "code": "legal_entity_confirmed",
      "type": "strength",
      "impact": "Confirms a valid legal entity through official sources.",
      "description": "Verified as an active, legally registered company in the United Kingdom."
    },
    {
      "code": "registry_identifier_anchored",
      "type": "strength",
      "impact": "Safe to use for deterministic record matching and deduplication.",
      "description": "The match is anchored by a stable government registry identifier."
    }
  ],
  "actions": [],
  "candidate": null,
  "basis": [
    {
      "field": "legal_name",
      "citations": [
        {
          "url": "www.companieshouse.gov.uk",
          "excerpt": "CLEO AI LTD. — England and Wales registration 09864205, status ACTIVE",
          "source_type": "government_registry",
          "authority_tier": 1
        },
        {
          "url": "https://meetcleo.com",
          "excerpt": "Cleo AI Ltd provides software solutions. The Company develops a money management mobile application for customers.",
          "source_type": "public_profile",
          "authority_tier": 2
        },
        {
          "url": "https://www.openbanking.org.uk/regulated-providers/cleo-ai-ltd/",
          "excerpt": "Cleo AI Ltd ... A money app and financial assistant that's helped 6 million people budget better, build credit, and escape their overdraft. https://web.meetcleo.",
          "source_type": "web",
          "authority_tier": 3
        }
      ],
      "reasoning": "The query 'Cleo AI' matches the active UK-registered company 'CLEO AI LTD.'. Multiple high-confidence sources verify this entity operates the financial technology mobile application identified in the search results.",
      "confidence": "high"
    },
    {
      "field": "status",
      "citations": [
        {
          "url": "www.companieshouse.gov.uk",
          "excerpt": "CLEO AI LTD. — England and Wales registration 09864205, status ACTIVE",
          "source_type": "government_registry",
          "authority_tier": 1
        }
      ],
      "reasoning": "Status taken from the matched government registry record.",
      "confidence": "high"
    },
    {
      "field": "description",
      "citations": [
        {
          "url": "https://meetcleo.com",
          "excerpt": "Cleo AI Ltd provides software solutions. The Company develops a money management mobile application for customers.",
          "source_type": "public_profile",
          "authority_tier": 2
        },
        {
          "url": "https://www.openbanking.org.uk/regulated-providers/cleo-ai-ltd/",
          "excerpt": "A money app and financial assistant that's helped 6 million people budget better, build credit, and escape their overdraft.",
          "source_type": "web",
          "authority_tier": 3
        }
      ],
      "reasoning": "Corroborated by the cited public sources below.",
      "confidence": "high"
    },
    {
      "field": "identifiers.0.value",
      "citations": [
        {
          "url": "www.companieshouse.gov.uk",
          "excerpt": "CLEO AI LTD. — England and Wales registration 09864205, status ACTIVE",
          "source_type": "government_registry",
          "authority_tier": 1
        }
      ],
      "reasoning": "Registration number from the matched government registry record.",
      "confidence": "high"
    },
    {
      "field": "industry",
      "citations": [
        {
          "url": "https://meetcleo.com",
          "excerpt": "Cleo AI Ltd provides software solutions. The Company develops a money management mobile application for customers.",
          "source_type": "public_profile",
          "authority_tier": 2
        },
        {
          "url": "https://www.openbanking.org.uk/regulated-providers/cleo-ai-ltd/",
          "excerpt": "A money app and financial assistant that's helped 6 million people budget better, build credit, and escape their overdraft.",
          "source_type": "web",
          "authority_tier": 3
        }
      ],
      "reasoning": "Industry classification: NAICS from the cited business activity; SIC (when present) derived from NAICS via crosswalk.",
      "confidence": "medium"
    },
    {
      "field": "facets.sector",
      "citations": [],
      "reasoning": "Ownership axis derived from the resolved entity's classification signals.",
      "confidence": "medium"
    },
    {
      "field": "facets.legal_form",
      "citations": [
        {
          "url": "www.companieshouse.gov.uk",
          "excerpt": "CLEO AI LTD. — England and Wales registration 09864205, status ACTIVE",
          "source_type": "government_registry",
          "authority_tier": 1
        }
      ],
      "reasoning": "Mapped from the resolved entity's legal-structure classification.",
      "confidence": "high"
    }
  ],
  "metadata": {
    "query": {
      "mode": "standard",
      "name": "Cleo AI",
      "context": null,
      "location": "London, UK",
      "classification": "specific"
    },
    "from_cache": false,
    "updated_at": "2026-11-12T20:21:01.926Z",
    "resolved_at": "2026-11-12T20:21:04.762Z",
    "cache_hit_type": null,
    "flagged_for_review": false
  }
}

Moving from v2

  • Same API key, same apikey header. A siq_ id from v2 works on GET /v3/entities/{id}.
  • v3 is async. Swap the v2 stream call for submit-then-poll, or pass webhook_url. The batch processing guide has production scripts in JavaScript and Python.
  • v1 has been retired. v2 keeps working, and its reference stays available as the 2026-07-30 edition.

Have a list? Send a CSV of company names or domains, up to 1,000 rows, to help@savvyiq.ai. We’ll run it through v3 and send back the legal names, identifiers and sources, free. Or get an API key and try it yourself.

Common questions

What is new in SavvyIQ v3?
v3 finds more small and international companies, returns NAICS industry codes and more identifiers (LEI, SEC CIK, EIN, DUNS, BIC, ticker) with every match, cites the source behind each field, reads non-Latin names, and delivers results by webhook. It is 90% faster and 50% cheaper than v1.
How much does the SavvyIQ API cost?
Entity Resolution, Business Intelligence and Domain Intelligence cost $0.10 per call. Status checks are free, and every new account starts with $25 in credit.
Does SavvyIQ return NAICS and SIC codes?
Yes. Every match includes NAICS 2022 codes, each with a confidence score and a primary code marked, plus SIC codes where available.
Can SavvyIQ match company names written in Japanese, Chinese or other non-Latin scripts?
Yes. Send the name as written, for example 株式会社ソニー with Tokyo, Japan, and v3 returns the registered company with its registration number.
How can I see why SavvyIQ matched a company?
Add include=basis to the request. Each field then comes with its sources: the URL, a direct quote from the registry or web page, a confidence level and the reasoning behind the choice.
How do I move from SavvyIQ v2 to v3?
Use the same API key and header. Submit the request, then poll the run_id or pass a webhook_url. v2 keeps working; v1 has been retired.
All posts

Keep reading

·7 min read

Who actually owns this company?

MG Motor UK is British by badge. Britain publishes three registers that answer the ownership question three different ways, and none of them holds the whole answer.

Read
·8 min read

The biggest category in most ransomware reports is "unknown"

A third of the victims in the best public ransomware research could not be resolved. Those records are not missing at random.

Read

Resolve your first entity in minutes

Sign up, get API keys instantly, and make your first call with $25 in free credit. One request returns a verified entity, drawn from 140+ official registries.

Get started free View documentation
GET /v3/runs/run_344tSxhAVACWbuENINJ9D 
{
  "run_id": "run_344tSxhAVACWbuENINJ9D",
  "status": "matched",
  "match_confidence": 100,
  "type": "business",
  "entity": {
    "id": "siq_33d67jj0wJESjEdFHMhuQ",
    "display_name": "Datadog",
    "legal_name": "DATADOG, INC.",
    "primary_legal_entity": {
      "jurisdiction": "US-DE"
    },
    "identifiers": [
      {
        "type": "registration_id",
        "value": "4832851",
        "jurisdiction": "US-DE"
      }
    ],
    "website": "https://www.datadoghq.com/"
  }
}