Implement a contract counterparty entity verification workflow combining GLEIF LEI lookup and Companies House data

Steps

1. Collect the counterparty's legal name, jurisdiction of incorporation, and any available identifiers (LEI, company registration number, VAT/EIN) at contract intake
2. Query the GLEIF API at https://api.gleif.org/api/v1/lei-records?filter[entity.legalName]={legalName}&filter[entity.jurisdiction]={ISO3166-2-code} to find matching LEI records; check that the entity status is ACTIVE and that the legal jurisdiction matches the counterparty's claimed incorporation country
3. If a match is found, retrieve the entity's direct and ultimate parent relationships via the relationship endpoints to build the ownership hierarchy; flag any parent entity with an LAPSED LEI for manual review
4. Cross-reference the entity details from GLEIF (registered address, business registry ID) against the Companies House Public Data API (for UK entities) or the relevant national registry to confirm the data is consistent
5. Store the verified LEI, legal name, jurisdiction, registration number, and verification timestamp in your contract metadata schema for audit and regulatory reporting purposes
6. Schedule a periodic LEI status re-check (at minimum annually, preferably quarterly) and trigger a contract manager alert if any counterparty LEI transitions to LAPSED or the entity's registration status changes to dissolved