research lei entity search derived

{
  "input": {
    "body": {
      "legal_name": "Apple Inc.",
      "max_results": 3,
      "country_code": "US"
    },
    "type": "http",
    "method": "POST",
    "bodyType": "json"
  },
  "output": {
    "type": "json",
    "example": {
      "data": {
        "query": {
          "mode": "legal_name",
          "value": "Apple Inc.",
          "maxResults": 3,
          "countryCode": "US"
        },
        "source": "https://api.gleif.org/api/v1/lei-records",
        "status": "matched",
        "license": {
          "id": "CC0-1.0",
          "url": "https://creativecommons.org/publicdomain/zero/1.0/",
          "termsUrl": "https://www.gleif.org/en/meta/lei-data-terms-of-use/"
        },
        "matches": [
          {
            "lei": "HWUPKR0MPOU8FGXBT394",
            "match": {
              "type": "exact",
              "score": 1
            },
            "legalName": "Apple Inc.",
            "otherNames": [
              {
                "name": "Apple Computer, Inc.",
                "type": "PREVIOUS_LEGAL_NAME",
                "language": "en"
              }
            ],
            "legalAddress": {
              "city": "Glendale",
              "region": "US-CA",
              "country": "US",
              "postalCode": "91203",
              "addressLines": [
                "C/O C T Corporation System",
                "330 N. Brand Blvd"
              ]
            }
          }
        ],
        "disclaimer": "Official public LEI reference data normalized from GLEIF. Corroborate name ma...",
        "matchCount": 1,
        "limitations": [
          "Name-match scores rank candidates but do not establish identity.",
          "Not every legal entity has an LEI, and source records may be stale or incompl...",
          "Relationship flags indicate available GLEIF links; they do not expand the rel..."
        ],
        "retrievedAt": "2026-08-11T08:30:00+00:00",
        "totalCandidates": 20,
        "goldenCopyPublishedAt": "2026-08-11T00:00:00Z"
      },
      "meta": {
        "cached": false,
        "sources": [],
        "warnings": [],
        "duration_ms": 42,
        "next_actions": [
          {
            "path": "/v1/research/organization-evidence",
            "title": "Official supplier evidence report",
            "method": "POST",
            "reason": "Expand a selected GLEIF candidate with independent USAspending, SEC filing-ac...",
            "service": "research.organization-evidence"
          }
        ]
      },
      "service": "research.lei-entity-search",
      "version": "1",
      "request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a"
    }
  }
}