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.

Official Coinbase agent path

Coinbase Agentic Wallet can satisfy this x402 request in one command. Running it may pay automatically, so --max-amount is fixed to $0.01 USDC in atomic units. Copying the command does not install, authenticate, sign, or pay; review the request and use a separate low-value wallet before running it.

npx --yes awal@latest x402 pay https://apiacre.com/v1/research/lei-entity-search \
  -X POST \
  -d '{"legal_name":"Apple Inc.","country_code":"US","max_results":3}' \
  --max-amount 10000 \
  --json

Coinbase pay-for-service documentation · Buyer setup and wallet safety

npx --yes agentcash@latest check https://apiacre.com/v1/research/lei-entity-search
npx --yes agentcash@latest fetch https://apiacre.com/v1/research/lei-entity-search \
  --method POST \
  --header 'content-type: application/json' \
  --body '{"legal_name":"Apple Inc.","country_code":"US","max_results":3}' \
  --payment-protocol x402 \
  --payment-network base \
  --max-amount 0.010

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": "research.organization-evidence",
        "title": "Official supplier evidence report",
        "reason": "Expand a selected GLEIF candidate with independent USAspending, SEC filing-activity, and OFAC Entity evidence in one separately authorized call.",
        "method": "POST",
        "path": "/v1/research/organization-evidence",
        "price": "$0.1",
        "input_template": {
          "legal_name": "$result.data.matches[0].legalName",
          "country_code": "$result.data.matches[0].legalAddress.country"
        },
        "use_output": "Continue only after selecting the intended GLEIF candidate. Treat every source section independently; the bundle does not prove that records refer to the same organization.",
        "handoff_path": "/catalog/research.organization-evidence",
        "checkout_path": "/try/research.organization-evidence",
        "sample_path": "/samples/research.organization-evidence",
        "maximum_atomic_usdc": "100000",
        "handoff_payment_required": false,
        "executes_automatically": false,
        "authorization_required": true
      },
      {
        "service": "web.business-due-diligence",
        "title": "Website and domain technical 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.1",
        "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.",
        "handoff_path": "/catalog/web.business-due-diligence",
        "checkout_path": "/try/web.business-due-diligence",
        "sample_path": "/samples/web.business-due-diligence",
        "maximum_atomic_usdc": "100000",
        "handoff_payment_required": false,
        "executes_automatically": false,
        "authorization_required": true
      },
      {
        "service": "research.ofac-entity-search",
        "title": "OFAC entity candidate evidence",
        "reason": "Compare a selected official legal name with current OFAC Entity records and aliases.",
        "method": "POST",
        "path": "/v1/research/ofac-entity-search",
        "price": "$0.02",
        "input_template": {
          "entity_name": "$result.data.matches[0].legalName",
          "minimum_score": 85,
          "max_results": 5,
          "include_weak_aliases": false
        },
        "use_output": "Review returned candidates against the official record and program authority; no candidate is not compliance clearance.",
        "handoff_path": "/catalog/research.ofac-entity-search",
        "checkout_path": "/try/research.ofac-entity-search",
        "sample_path": "/samples/research.ofac-entity-search",
        "maximum_atomic_usdc": "20000",
        "handoff_payment_required": false,
        "executes_automatically": false,
        "authorization_required": true
      }
    ]
  }
}

Complete recipes using this API

These buyer-controlled recipes connect this service to compatible API Acre results. Every step has its own exact price and requires separate authorization.

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}'