find_missing

Product · v0 · Class A

find_missing

Checks whether an entity that already has a real LEI (Legal Entity Identifier) has a high-confidence match in the national commercial registry its own declared jurisdiction would expect — UK Companies House, Spain BORME, France SIRENE. Never claims illegality, fraud or a shell entity — only "no high-confidence match", always with the expectation rule that explains why a match was expected in the first place.

Real example

Request:

POST https://api.nkodatalabs.com/v0/find_missing
x-api-key: <your key>
content-type: application/json

{"identifier_type": "lei", "identifier": "2138002P5RNKC5W2JZ46", "jurisdiction": "GB"}

Response (real, live TESCO PLC lookup):

{
  "entity_seen_in": [
    {"registry": "GLEIF (global LEI index)", "id": "2138002P5RNKC5W2JZ46", "matched_on": "lei", "confidence": 1.0},
    {"registry": "UK Companies House", "id": "00445790", "matched_on": "gleif.registration.validatedAt", "confidence": 0.95}
  ],
  "expected_in": [
    {"registry": "UK Companies House", "reason": "Every company incorporated in England/Wales, Scotland or Northern Ireland must register with Companies House."}
  ],
  "not_found_in": [],
  "candidates": [],
  "verdict": "CONSISTENT",
  "method_version": "nko-find-missing-v0.1-2026-08-31",
  "evidence_refs": ["GLEIF API https://api.gleif.org/api/v1/lei-records (live query)", "entity_legal_name='TESCO PLC'"]
}

Ambiguous names (e.g. "Banco Santander", which has 25+ real LEIs) never get a verdict picked blindly — the API returns a candidates[] list instead, and asks you to disambiguate with a specific LEI.

Get a free key

Self-service, no approval — POST /v0/keys with your email returns a key instantly.

Python client

pip install nko
import nko
nko.find_missing("name", "Tesco PLC", jurisdiction="GB", api_key="your_key")

Limits

Free, v0, no availability guarantee. 100 calls/month per key — further calls return 429 until next calendar month. A revoked key returns 403. Requests without a valid x-api-key return 401.

Need more than 100/month?

One credit pack, no subscription: 1,000 calls for €19, never expires. Uses the key from the section above (saved in this browser) — request one first if you haven't.

Sources & attribution

The only live source queried is GLEIF (Global Legal Entity Identifier Foundation) — public, no authentication required. GLEIF record data references the national registration authorities it validates against: UK Companies House, Spain's Registro Mercantil (BORME), and France's Sirene (INSEE). Those three registries are used under a "review" legal status internally (mandatory attribution, not GREEN/unrestricted) — this product only echoes registry identifiers already published by GLEIF itself, it does not scrape or redistribute the national registries directly.

Re-identification notice: combining a global LEI with a specific national registration number links two otherwise-separate public identifiers for the same entity. Both are already public individually; this product makes the cross-reference explicit rather than novel information. No personal data about individuals is processed — LEI records describe legal entities, not people.