GLEIF Level 1 LEI records linked to a Swiss UID by exact identifier equality
Returns the GLEIF Level 1 records whose Swiss commercial-register identifier exactly equals the queried canonical UID. result is FOUND, NOT_FOUND, MULTIPLE_RECORDS or UNKNOWN.
Linkage (LEI_LOOKUP): deterministic identifier equality only. A record matches when entity.registeredAt.id is exactly RA000548 AND entity.registeredAs is exactly the compact form of the queried canonical UID. GLEIF publishes the Swiss identifier compact, without the CHE- dash and without dot separators (for example CHE102753938); BUMIT applies that formatting transform on the query side only and never rewrites the stored source value. registration.validatedAt and registration.validatedAs are reported as corroborating evidence and are never required for linkage. No legal name, address, city, legal-form, punctuation-heuristic, similarity-score, fuzzy or LLM matching exists anywhere in this path.
Result semantics: FOUND means one exact record exists — never that the company is active, solvent, authorised, compliant or safe to transact with. NOT_FOUND means only that no exact record existed in the stored GLEIF data, is emitted only after a successful lookup against usable data, and never means the company does not exist. MULTIPLE_RECORDS returns every exact record and resolves none: no selection is made on registration status, dates, name similarity or ordering, because a Swiss UID is not assumed to map to exactly one LEI. UNKNOWN covers an unavailable, invalid, malformed or stale dataset and an unusable UID, and is never a negative finding.
Statuses: entity.status and registration.status are two independent questions, kept separate and verbatim, including unknown or future source values. An ISSUED LEI is not COMPANY_ACTIVE; a LAPSED LEI is neither COMPANY_INACTIVE nor COMPANY_DOES_NOT_EXIST; RETIRED carries only its documented GLEIF meaning. There is no LEI_OK, LEI_TRUSTED, SAFE or VERIFIED_SAFE state.
Level 2: no parent-relationship engine is implemented. A GLEIF accounting-consolidating parent is not a beneficial owner, not a UBO and not a controlling natural person, and a reporting exception such as NO_KNOWN_PERSON is never transformed into NO_PARENT, NO_OWNER or NO_UBO. Reporting exceptions are retained verbatim and their composite identifiers are stored whole, never parsed.
Provenance separates BUMIT's retrieved_at from GLEIF source dates: registration.lastUpdateDate is a source field and is never treated as a retrieval time, and meta.goldenCopy.publishDate is retained only where GLEIF actually supplied it and is never a sole cache validator.
GLEIF live retrieval is not implemented: there is no request path, no Golden Copy download, no delta synchronisation and no scheduler. This deployment serves synthetic fixture datasets, marked evidence_class: SYNTHETIC_FIXTURE.
Request
- Base URL: https://bumit.ai
- URL: https://bumit.ai/api/v1/company/{uid}/lei
- Auth: none required
Path parameters
Swiss UID in canonical or compact form, e.g. CHE-123.456.789.
Response
LEI lookup result with linkage descriptor, every exact record, coverage, matching ruleset, claims, freshness, provenance and attribution.
Changes
No recorded changes to this operation across all 1 revision of this API.