GLEIF legal entity search

Endpoint

https://apiacre.com/v1/research/lei-entity-search

Send the JSON body below. An unpaid request returns HTTP 402 with a PAYMENT-REQUIRED header; an x402-compatible buyer signs the requirement and retries with PAYMENT-SIGNATURE.

Input example

{
  "legal_name": "Apple Inc.",
  "country_code": "US",
  "max_results": 3
}

Response shape

View free static sample JSON

{
  "request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a",
  "service": "research.lei-entity-search",
  "version": "1",
  "data": {
    "status": "matched",
    "query": {
      "mode": "legal_name",
      "value": "Apple Inc.",
      "countryCode": "US",
      "maxResults": 3
    },
    "matchCount": 1,
    "totalCandidates": 20,
    "matches": [
      {
        "lei": "HWUPKR0MPOU8FGXBT394",
        "legalName": "Apple Inc.",
        "otherNames": [
          {
            "name": "Apple Computer, Inc.",
            "type": "PREVIOUS_LEGAL_NAME",
            "language": "en"
          }
        ],
        "match": {
          "type": "exact",
          "score": 1.0
        },
        "legalAddress": {
          "addressLines": [
            "C/O C T Corporation System",
            "330 N. Brand Blvd"
          ],
          "city": "Glendale",
          "region": "US-CA",
          "country": "US",
          "postalCode": "91203"
        },
        "headquartersAddress": {
          "addressLines": [
            "One Apple Park Way"
          ],
          "city": "Cupertino",
          "region": "US-CA",
          "country": "US",
          "postalCode": "95014"
        },
        "registeredAs": "806592",
        "jurisdiction": "US-CA",
        "category": "GENERAL",
        "legalForm": {
          "id": "H1UM",
          "other": null
        },
        "entityStatus": "ACTIVE",
        "creationDate": "1977-01-03T00:00:00Z",
        "registrationAuthority": {
          "id": "RA000598",
          "other": null
        },
        "registration": {
          "status": "ISSUED",
          "initialDate": "2012-06-06T15:53:00Z",
          "lastUpdated": "2026-03-03T16:34:33Z",
          "nextRenewal": "2027-03-08T17:27:20Z",
          "corroborationLevel": "FULLY_CORROBORATED",
          "validationAuthority": {
            "id": "RA000598",
            "other": null
          }
        },
        "mappedIdentifiers": {
          "bic": [
            "APLEUS66XXX"
          ],
          "spGlobal": [
            "24937"
          ]
        },
        "relationshipsAvailable": {
          "directParent": false,
          "directParentException": true,
          "ultimateParent": false,
          "ultimateParentException": true,
          "directChildren": true,
          "ultimateChildren": true,
          "isins": true
        },
        "conformityFlag": "CONFORMING",
        "source": "https://api.gleif.org/api/v1/lei-records/HWUPKR0MPOU8FGXBT394"
      }
    ],
    "goldenCopyPublishedAt": "2026-08-11T00:00:00Z",
    "source": "https://api.gleif.org/api/v1/lei-records",
    "retrievedAt": "2026-08-11T08:30:00+00:00",
    "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/"
    },
    "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 incomplete.",
      "Relationship flags indicate available GLEIF links; they do not expand the relationship records."
    ],
    "disclaimer": "Official public LEI reference data normalized from GLEIF. Corroborate name matches before KYC, credit, legal, compliance, or counterparty decisions."
  },
  "meta": {
    "duration_ms": 42,
    "cached": false,
    "sources": [],
    "warnings": [],
    "next_actions": [
      {
        "service": "web.business-due-diligence",
        "title": "Business domain due diligence",
        "reason": "Combine a selected legal-entity candidate with public website, DNS, TLS, RDAP, and site-quality evidence.",
        "method": "POST",
        "path": "/v1/web/business-due-diligence",
        "price": "$0.35",
        "input_template": {
          "url": "$companyDomainUrl",
          "legal_name": "$result.data.matches[0].legalName",
          "country_code": "$result.data.matches[0].legalAddress.country"
        },
        "use_output": "Continue only after selecting the correct candidate; the follow-up report does not prove that the entity controls the domain.",
        "authorization_required": true
      }
    ]
  }
}

Continue this workflow

These optional follow-ups use this result in a larger workflow. Each call shows a fresh x402 challenge and requires separate buyer authorization.

Try the payment challenge

curl -i -X POST 'https://apiacre.com/v1/research/lei-entity-search' \
  -H 'content-type: application/json' \
  --data '{"legal_name":"Apple Inc.","country_code":"US","max_results":3}'