Legal Entity Identifier

curl -X POST https://win.oneshotagent.com/v1/tools/lookup/company-legal-identifier \
  -H "Content-Type: application/json" \
  -H "payment-signature: <base64 x402 payment>" \
  -d '{
    "lei": "DPRBOZP0K5RM2YE8UU08"
  }'

const response = await fetch("https://win.oneshotagent.com/v1/tools/lookup/company-legal-identifier", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "payment-signature": paymentProof,
  },
  body: JSON.stringify({
    "lei": "DPRBOZP0K5RM2YE8UU08"
  }),
});

const result = await agent.tool('lookup/company-legal-identifier', {
  lei: 'DPRBOZP0K5RM2YE8UU08'
});
console.log(result.data.result);
console.log(result.data.evidence);

{
  "success": true,
  "data": {
    "request_id": "uuid",
    "receipt_id": "rcpt_...",
    "status": "completed",
    "tool": "company_legal_identifier",
    "result": {
      "total": 1,
      "entities": [
        {
          "lei": "DPRBOZP0K5RM2YE8UU08",
          "legal_name": "LOCKHEED MARTIN CORPORATION",
          "other_names": [],
          "entity_status": "ACTIVE",
          "jurisdiction": "US-MD",
          "legal_form_code": "HLR4",
          "registered_as": "D03964756",
          "created_on": "1994-08-29",
          "registration_status": "ISSUED",
          "registered_on": "2012-06-06",
          "last_updated_on": "2026-05-06",
          "next_renewal_on": "2027-05-29",
          "corroboration": "FULLY_CORROBORATED",
          "legal_address": {
            "lines": [
              "C/O CSC-LAWYERS INCORPORATING SERVICE COMPANY",
              "7 ST. PAUL STREET",
              "SUITE 820"
            ],
            "city": "BALTIMORE",
            "region": "US-MD",
            "country": "US",
            "postal_code": "21202"
          },
          "headquarters_address": {
            "lines": [
              "6801 ROCKLEDGE DR"
            ],
            "city": "BETHESDA",
            "region": "US-MD",
            "country": "US",
            "postal_code": "20817"
          }
        }
      ]
    },
    "evidence": {
      "source": "Global Legal Entity Identifier Foundation",
      "source_kind": "public",
      "retrieved_at": "2026-01-15T12:00:00.000Z",
      "as_of": null
    }
  }
}

POST

tools

lookup

company-legal-identifier

curl -X POST https://win.oneshotagent.com/v1/tools/lookup/company-legal-identifier \
  -H "Content-Type: application/json" \
  -H "payment-signature: <base64 x402 payment>" \
  -d '{
    "lei": "DPRBOZP0K5RM2YE8UU08"
  }'

const response = await fetch("https://win.oneshotagent.com/v1/tools/lookup/company-legal-identifier", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "payment-signature": paymentProof,
  },
  body: JSON.stringify({
    "lei": "DPRBOZP0K5RM2YE8UU08"
  }),
});

const result = await agent.tool('lookup/company-legal-identifier', {
  lei: 'DPRBOZP0K5RM2YE8UU08'
});
console.log(result.data.result);
console.log(result.data.evidence);

{
  "success": true,
  "data": {
    "request_id": "uuid",
    "receipt_id": "rcpt_...",
    "status": "completed",
    "tool": "company_legal_identifier",
    "result": {
      "total": 1,
      "entities": [
        {
          "lei": "DPRBOZP0K5RM2YE8UU08",
          "legal_name": "LOCKHEED MARTIN CORPORATION",
          "other_names": [],
          "entity_status": "ACTIVE",
          "jurisdiction": "US-MD",
          "legal_form_code": "HLR4",
          "registered_as": "D03964756",
          "created_on": "1994-08-29",
          "registration_status": "ISSUED",
          "registered_on": "2012-06-06",
          "last_updated_on": "2026-05-06",
          "next_renewal_on": "2027-05-29",
          "corroboration": "FULLY_CORROBORATED",
          "legal_address": {
            "lines": [
              "C/O CSC-LAWYERS INCORPORATING SERVICE COMPANY",
              "7 ST. PAUL STREET",
              "SUITE 820"
            ],
            "city": "BALTIMORE",
            "region": "US-MD",
            "country": "US",
            "postal_code": "21202"
          },
          "headquarters_address": {
            "lines": [
              "6801 ROCKLEDGE DR"
            ],
            "city": "BETHESDA",
            "region": "US-MD",
            "country": "US",
            "postal_code": "20817"
          }
        }
      ]
    },
    "evidence": {
      "source": "Global Legal Entity Identifier Foundation",
      "source_kind": "public",
      "retrieved_at": "2026-01-15T12:00:00.000Z",
      "as_of": null
    }
  }
}

Look up registered legal entities by a company’s legal name or by its 20-character Legal Entity Identifier. Give exactly one of name and lei. Each entity has its identifier, legal name and other names, entity status, jurisdiction, legal form code, registration number, creation date, the identifier’s registration status, registration, last update and next renewal dates, how well the record is corroborated, and its legal and headquarters addresses. It answers whether this is the legal entity you think it is, and whether its registration is current. A name is a text match, so similarly named entities come back too: tell them apart by the identifier on each row, and prefer the identifier when you have it, since it is an exact match. total is the number of entities that matched, which may be more than limit. No match is a completed result with total 0 and an empty list. Covers legal entities that hold an identifier; parent and child relationships are not included.

Authentication

Requires x402 payment in the payment-signature header.

Request Body

string

The 20-character Legal Entity Identifier, for example DPRBOZP0K5RM2YE8UU08. An exact match; preferred over a name. A Legal Entity Identifier is 20 letters and digits.

string

Legal name, for example Lockheed Martin Corporation. A text match: similarly named entities are returned too. 2 to 200 characters.

integer

Most entities to return (1 to 10, default 5). From 1 to 10. Defaults to 5.

Response (200 OK)

Top-level envelope: success (boolean) and data (object). All fields below are nested under data.

string

Durable job ID for audit and lookup

string

Job status: completed

string

Always company_legal_identifier

object

The answer, described under Result below

object

Where the answer came from and when

string

The public body the data comes from. Always Global Legal Entity Identifier Foundation.

string

public when the data comes from a public body, commercial otherwise

string

When the lookup was made, as an ISO 8601 UTC time

string

When the source says the fact was last updated, or null when the source gives no date

Result

Nested under data.result.

integer

How many entities matched in all; may be more than were returned.

object[]

Matching entities; empty when none match.

string

The 20-character Legal Entity Identifier; use it to tell similarly named entities apart.

string

The legal name as registered. null when the source gives no value.

string[]

Other registered names of the entity.

string

Status of the legal entity, for example ACTIVE. null when the source gives no value.

string

Jurisdiction of formation, for example US-MD. null when the source gives no value.

string

Code of the legal form, from the source’s legal form list. null when the source gives no value.

string

The entity’s registration number at its business register. null when the source gives no value.

string

Date the entity was created, YYYY-MM-DD. null when the source gives no value.

string

Status of the identifier’s registration, for example ISSUED or LAPSED. null when the source gives no value.

string

Date the identifier was first registered, YYYY-MM-DD. null when the source gives no value.

string

Date the registration record was last updated, YYYY-MM-DD. null when the source gives no value.

string

Date the registration is next due for renewal, YYYY-MM-DD. null when the source gives no value.

string

How well the record is corroborated by the business register, for example FULLY_CORROBORATED. null when the source gives no value.

object

Legal address. null when the source gives no value.

string[]

Street lines, as registered.

string

City. null when the source gives no value.

string

Region code, for example US-MD. null when the source gives no value.

string

Two-letter country code. null when the source gives no value.

string

Postal code. null when the source gives no value.

object

Headquarters address. null when the source gives no value.

string[]

Street lines, as registered.

string

City. null when the source gives no value.

string

Region code, for example US-MD. null when the source gives no value.

string

Two-letter country code. null when the source gives no value.

string

Postal code. null when the source gives no value.

curl -X POST https://win.oneshotagent.com/v1/tools/lookup/company-legal-identifier \
  -H "Content-Type: application/json" \
  -H "payment-signature: <base64 x402 payment>" \
  -d '{
    "lei": "DPRBOZP0K5RM2YE8UU08"
  }'

const response = await fetch("https://win.oneshotagent.com/v1/tools/lookup/company-legal-identifier", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "payment-signature": paymentProof,
  },
  body: JSON.stringify({
    "lei": "DPRBOZP0K5RM2YE8UU08"
  }),
});

const result = await agent.tool('lookup/company-legal-identifier', {
  lei: 'DPRBOZP0K5RM2YE8UU08'
});
console.log(result.data.result);
console.log(result.data.evidence);

{
  "success": true,
  "data": {
    "request_id": "uuid",
    "receipt_id": "rcpt_...",
    "status": "completed",
    "tool": "company_legal_identifier",
    "result": {
      "total": 1,
      "entities": [
        {
          "lei": "DPRBOZP0K5RM2YE8UU08",
          "legal_name": "LOCKHEED MARTIN CORPORATION",
          "other_names": [],
          "entity_status": "ACTIVE",
          "jurisdiction": "US-MD",
          "legal_form_code": "HLR4",
          "registered_as": "D03964756",
          "created_on": "1994-08-29",
          "registration_status": "ISSUED",
          "registered_on": "2012-06-06",
          "last_updated_on": "2026-05-06",
          "next_renewal_on": "2027-05-29",
          "corroboration": "FULLY_CORROBORATED",
          "legal_address": {
            "lines": [
              "C/O CSC-LAWYERS INCORPORATING SERVICE COMPANY",
              "7 ST. PAUL STREET",
              "SUITE 820"
            ],
            "city": "BALTIMORE",
            "region": "US-MD",
            "country": "US",
            "postal_code": "21202"
          },
          "headquarters_address": {
            "lines": [
              "6801 ROCKLEDGE DR"
            ],
            "city": "BETHESDA",
            "region": "US-MD",
            "country": "US",
            "postal_code": "20817"
          }
        }
      ]
    },
    "evidence": {
      "source": "Global Legal Entity Identifier Foundation",
      "source_kind": "public",
      "retrieved_at": "2026-01-15T12:00:00.000Z",
      "as_of": null
    }
  }
}

Price: $0.005 per lookup. See Pricing for every tool.

Notes

Results return inline. The finished job stays available at /v1/requests/{request_id}

Overview

Messaging

Research & Enrich

Lookups

Web & Browser

Build

Commerce

Account

Compute

Budgets

Approvals

Receipts & Analytics

Credits

Other

Legal Entity Identifier

Authentication

Request Body

Response (200 OK)

Result

Notes

​Authentication

​Request Body

​Response (200 OK)

​Result

​Notes

Authentication

Request Body

Response (200 OK)

Result

Notes