Skip to content

LEI Lookup

Resolve a Legal Entity Identifier (LEI) for the target company on an existing case via the Global LEI Foundation (GLEIF).

Unlike a free-form LEI code lookup, this endpoint:

  1. Loads cases/{caseId}.target
  2. Fuzzy-matches target.legalName against GLEIF
  3. On exact name match, fetches the full LEI record and writes it onto target.lei
  4. Records a searchType: "lei" search on the case

Attach LEI to a case target

Request

POST https://api.revolutio.systems/searchgleif/lei
Content-Type: application/json

Headers

Header Value
Content-Type application/json
X-API-Key or Authorization API key or Bearer token

Body

{
  "caseId": "xyz789caseId"
}
Field Type Required Description
caseId string Yes Case whose target should be enriched with an LEI

Info

The case must already have a target with a legalName (typically after a completed root search). Only the case owner may call this endpoint.

Response

The response is the LEI search document (same async lifecycle shape as other searches, but completed within the request).

{
  "_id": "lei-search-id",
  "caseId": "xyz789caseId",
  "createdAt": "2026-01-15T10:35:00.000Z",
  "updatedAt": "2026-01-15T10:35:01.000Z",
  "userId": "user-uid",
  "searchType": "lei",
  "searchInputs": {
    "legalName": "EXAMPLE LTD"
  },
  "status": "COMPLETED",
  "result": {
    "lei": "5493001KJTIIGC8Y1R12",
    "legalName": "EXAMPLE LTD",
    "bic": null,
    "category": "GENERAL",
    "lei_status": "ISSUED",
    "last_update_date": "2024-06-01T00:00:00Z",
    "otherNames": []
  }
}

On success, case.target.lei is also updated. Full result stays on searches/{searchId}; the case embeds only a search summary.

{
  "_id": "lei-search-id",
  "caseId": "xyz789caseId",
  "searchType": "lei",
  "searchInputs": { "legalName": "EXAMPLE LTD" },
  "status": "COMPLETED",
  "result": {
    "message": "No matching LEI found"
  }
}

The case target is left unchanged. Credits charged for LEI (if any) are refunded when no LEI is returned.

{ "error": "Missing or invalid caseId" }

{ "error": "Case target is missing legalName" }

{ "error": "Forbidden" }

{ "error": "Case not found" }

{
  "_id": "lei-search-id",
  "status": "FAILED",
  "result": { "error": "…" }
}

Credits

LEI is a global (non-jurisdictional) include. Cost is read from coverage configuration and is often 0. When a positive cost applies:

  • Charged before the GLEIF calls
  • Refunded on no-match or error
  • Kept only when an LEI is successfully attached

Example (cURL)

curl -sS -X POST https://api.revolutio.systems/searchgleif/lei \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $REV_API_KEY" \
  -d '{"caseId": "xyz789caseId"}' | jq .

LEI object on the entity

After a successful match, the case target includes:

{
  "lei": {
    "lei": "5493001KJTIIGC8Y1R12",
    "legalName": "EXAMPLE LTD",
    "category": "GENERAL",
    "lei_status": "ISSUED",
    "last_update_date": "2024-06-01T00:00:00Z",
    "bic": "EXAMPGB2L",
    "otherNames": []
  }
}

See Entity.