First Resolution (Cloud)

This guide covers real-time identity resolution using the Kanoniv Cloud API - resolving identities by external ID, searching entities, and exploring linked records in under 1ms.

This is a Kanoniv Cloud feature

Real-time resolution requires a deployed identity graph on Kanoniv Cloud. For the full guide including setup, API examples, async client usage, and batch resolution, see Kanoniv Cloud.

Looking for local batch reconciliation?

If you want to reconcile data locally without a server - load CSVs, run matching, and export golden records - see First Reconciliation instead. No account or API key required.

How It Works

1. Write a YAML identity schema defining your sources, matching rules, and survivorship strategy
2. Deploy the schema to Kanoniv Cloud
3. Query the resolution API to look up any identity in under 1ms

GET /v1/resolve?system={source_name}&id={external_id}

The endpoint takes an external identifier (like a CRM contact ID or Stripe customer ID) and returns the canonical identity - the golden record with data merged from all linked sources.

Example Response

{
  "canonical_id": "550e8400-e29b-41d4-a716-446655440000",
  "external_id": "contact_123",
  "system": "crm",
  "entity_type": "customer",
  "confidence": 0.94,
  "matched_on": ["email_exact", "name_fuzzy"],
  "canonical_data": {
    "email": "[email protected]",
    "name": "John Doe",
    "company": "Acme Corp",
    "plan": "enterprise"
  },
  "field_provenance": {
    "email": "crm",
    "name": "crm",
    "company": "crm",
    "plan": "billing"
  },
  "linked_sources": ["crm", "billing"]
}

Next Steps

• Kanoniv Cloud - Full cloud SDK reference with setup, async client, batch resolution, and more
• First Reconciliation - Local batch reconciliation walkthrough
• Identity Schema Configuration - Full schema configuration options