API Acre · Research LEI Entity Search

import { wrapFetchWithPayment } from "@x402/fetch";
import { privateKeyToAccount } from "viem/accounts";

const account = privateKeyToAccount(process.env.PRIVATE_KEY);
const fetchWithPay = wrapFetchWithPayment(fetch, account);

const res = await fetchWithPay("https://apiacre.com/v1/research/lei-entity-search", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    "country_code": "US",
    "legal_name": "Apple Inc.",
    "max_results": 3
  }),
});
const data = await res.json();

curl -X POST \
  "https://apiacre.com/v1/research/lei-entity-search" \
  -H "Content-Type: application/json" \
  -d '{"country_code":"US","legal_name":"Apple Inc.","max_results":3}' \
  -H "X-PAYMENT: <signed x402 payment>"

{
  "data": {
    "disclaimer": "Official public LEI reference data normalized from GLEIF. Corroborate name ma...",
    "goldenCopyPublishedAt": "2026-08-11T00:00:00Z",
    "license": {
      "id": "CC0-1.0",
      "termsUrl": "https://www.gleif.org/en/meta/lei-data-terms-of-use/",
      "url": "https://creativecommons.org/publicdomain/zero/1.0/"
    },
    "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..."
    ],
    "matchCount": 1,
    "matches": [
      {
        "legalAddress": {
          "addressLines": [
            "C/O C T Corporation System",
            "330 N. Brand Blvd"
          ],
          "city": "Glendale",
          "country": "US",
          "postalCode": "91203",
          "region": "US-CA"
        },
        "legalName": "Apple Inc.",
        "lei": "HWUPKR0MPOU8FGXBT394",
        "match": {
          "score": 1,
          "type": "exact"
        },
        "otherNames": [
          {
            "language": "en",
            "name": "Apple Computer, Inc.",
            "type": "PREVIOUS_LEGAL_NAME"
          }
        ]
      }
    ],
    "query": {
      "countryCode": "US",
      "maxResults": 3,
      "mode": "legal_name",
      "value": "Apple Inc."
    },
    "retrievedAt": "2026-08-11T08:30:00+00:00",
    "source": "https://api.gleif.org/api/v1/lei-records",
    "status": "matched",
    "totalCandidates": 20
  },
  "meta": {
    "cached": false,
    "duration_ms": 42,
    "next_actions": [
      {
        "method": "POST",
        "path": "/v1/research/organization-evidence",
        "reason": "Expand a selected GLEIF candidate with independent USAspending, SEC filing-ac...",
        "service": "research.organization-evidence",
        "title": "Official supplier evidence report"
      }
    ],
    "sources": [],
    "warnings": []
  },
  "request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a",
  "service": "research.lei-entity-search",
  "version": "1"
}