Entity Resolution API

Transform messy, unstructured business data into clean, verified entity records using our AI agent-driven resolution system.

Overview

The Entity Resolution API automates complex business entity identification that enterprises previously required manual research teams to complete. Unlike traditional fuzzy matching against static datasets, our AI agent-driven approach specializes in the "long tail" of businesses with minimal web presence—processing messy, unstructured data that conventional systems cannot handle.

Key capabilities:

AI agent-driven research: Not just database lookups, but intelligent investigation across multiple sources
Long-tail focus: Specializes in hard-to-find entities with minimal web presence
Global government record linking: Connects entities to consistent official records worldwide
Messy data handling: Processes unstructured input that would previously require human researchers

This API enables enterprises to replace manual research processes for entities mentioned in legal documents, real estate LLCs, and other businesses that lack significant online presence.

Learn more: Entities and Candidates explains the core concepts behind entity resolution.

The Challenge: Why This Is Hard

Traditional entity resolution fails when dealing with real-world, messy data. Enterprises frequently encounter complex inputs where legal names are embedded within unstructured metadata, location data ranges from absent to incomplete, and each case requires distinct investigation strategies.

These challenges previously required dedicated human research teams to process entity names mixed with tax IDs, addresses, legal structure changes, and multilingual variations across different jurisdictions.

Dealing with messy data? See our Handling Messy Data Guide for detailed examples and solutions.

How Entity Resolution Works

Our AI agent system handles entity resolution through an intelligent, multi-step process:

Core Process

Database Check: First checks cached results for instant responses
AI Agent Research: If not cached, deploys intelligent agents for real-time investigation
Multi-Source Consensus: Agents gather evidence from multiple sources and build consensus
Government Record Matching: Links to official records when possible

Response Data Structure

The API delivers essential business intelligence:

Official Identity: The registered legal name and business structure
Operational Location: Verified business addresses and jurisdictions
Business Activity: Accurate description of primary business functions
Unique Identifier: Entity ID for integration with other SavvyIQ APIs

Response records prioritize data accuracy over breadth—delivering verified information rather than unconfirmed details.

Learn more:

Data Sources for our global coverage and jurisdiction details

Identifiers for Entity ID generation and usage

Performance & API Design

Current Characteristics

Optimized for accuracy and cost efficiency over raw speed
Response times: Few seconds (cached results) to couple minutes (complex research)
Variable timing: Depends on business complexity and available sources
Intelligent stopping: Agent searches until consensus reached or maximum effort expended

API Options

Streaming API

Holds connection open for real-time lookup
Best for interactive applications
Immediate feedback on research progress

Async API (Recommended)

Submit request → receive task identifier → poll status endpoint
Better for batch processing and higher request limits
Preferred by most customers for production workflows

Response Types

Successful matches: Return entity records with Entity ID
Inconclusive results: When insufficient data found after maximum search effort
Detailed explanations: Include confidence factors and research methodology

Performance roadmap: Speed improvements are our top development priority and actively in progress.

Entity Classification & Explainability

Business Type Classification

Each resolved entity receives detailed classification:

Primary business type (Corporation, LLC, Partnership, etc.)
Industry subtype when determinable
Jurisdiction-specific legal forms

Transparency Features

Our AI agents provide full explainability:

Confidence Scoring

Detailed confidence factors for each data point
Strength assessment based on source quality and consensus
Limitations analysis highlighting areas of uncertainty

Actionable Recommendations

Suggestions for improving resolution accuracy
Alternative search strategies for inconclusive results
Data quality improvements for future requests

Learn more:

Entities and Candidates for classification details

Confidence and Explainability for scoring methodology

Integration Workflow

The Entity Resolution API serves as the foundation for the entire SavvyIQ platform:

Basic Integration Pattern

1. Submit messy business data → Entity Resolution API
2. Receive Entity ID and basic information
3. Use entity ID → Business Intelligence API for expanded data
4. Future APIs will use same entity ID for specialized data

Platform Foundation

Consistent identifier: Entity ID works across all SavvyIQ APIs
Future-proof: New APIs will leverage the same entity foundation
Workflow optimization: Resolve once, enrich everywhere

Example Response

Here's a sample response for Google showing the complete data structure:

{
    "request_id": "req_30FFpfBX6Z2qYnajyvjSS",
    "status": "matched",
    "confidence": 98,
    "type": "business",
    "subtype": "incorporated_entity",
    "entity": {
        "id": "siq_2ZUKocPbFCPLClZ5XtHlJ",
        "name": "Apple",
        "status": "active",
        "description": "Apple Inc. is a multinational technology company that designs, develops, and sells consumer electronics, computer software, and online services. It is known for its innovative products and a strong brand reputation. The company operates through various segments, offering a range of hardware, software, and services to a global customer base.",
        "headquarters": {
            "address": "ONE APPLE PARK WAY",
            "city": "Cupertino",
            "state": "California",
            "country": "United States",
            "state_code": "CA",
            "country_code": "US"
        },
        "website": "https://www.apple.com/",
        "primary_legal_entity": {
            "id": "le_2ZoRp6I3EUgebkUBHaDdk",
            "name": "APPLE INC.",
            "country_code": "US",
            "state_code": null,
            "jurisdiction": "California"
        },
        "parent_entity": {
            "name": null
        },
        "matching_branch": {
            "jurisdiction": "California",
            "state_code": "CA",
            "country_code": "US",
            "address": "1 Apple Park Way, Cupertino, CA 95014",
            "notes": "This is Apple's headquarters location."
        }
    },
    "candidate": null,
    "factors": [
        {
            "type": "strength",
            "code": "name_exact_match",
            "description": "The provided name 'Apple' exactly matches the legal entity name 'Apple'",
            "impact": "Strong identifier for the correct entity."
        },
        {
            "type": "strength",
            "code": "jurisdiction_match",
            "description": "The entity's jurisdiction (California) matches the query's location (Cupertino, California).",
            "impact": "Confirms the entity operates within the specified jurisdiction."
        },
        {
            "type": "strength",
            "code": "multiple_sources_corroboration",
            "description": "Multiple authoritative sources confirm details about 'Apple' and its location.",
            "impact": "Increases confidence in the accuracy and reliability of the matched entity."
        },
        {
            "type": "strength",
            "code": "headquarters_match",
            "description": "The provided location 'Cupertino, California' matches the entity's registered headquarters.",
            "impact": "Confirms this is the primary legal entity location"
        },
        {
            "type": "strength",
            "code": "legal_entity_confirmed",
            "description": "A valid legal entity was confirmed through official sources.",
            "impact": "Verifies the legal existence and status of the matched entity."
        }
    ],
    "actions": [],
    "metadata": {
        "query": {
            "name": "Apple",
            "location": "Cupertino, california, usa",
            "context": null,
            "mode": "standard",
            "classification": "ambiguous"
        },
        "updated_at": "2025-08-03T19:47:45.445Z",
        "resolved_at": "2025-08-05T05:40:36.477Z",
        "from_cache": false,
        "cache_hit_type": null
    }
}

API Reference

Endpoints

POST `/entity-resolution`

Resolve a business entity from messy input data.

Loading...

Next Steps:

Get started: API Reference - Interactive endpoint documentation and examples
Understand responses: Confidence and Explainability - Interpret data quality scores
Scale up: Batch Processing - Process multiple entities efficiently

Questions? Our support team specializes in helping customers optimize their entity resolution workflows.