# Global Legal Entities

**Global Legal Entities** is an independently documented x402 Atlas bridge at https://legal-entities.use.x402atlas.com.
This document describes only this bridge; it does not aggregate routes, schemas,
or content from any other bridge.

## How payment works

Paid operations use the [x402 payment protocol](https://x402.org) and settle in
USDC. Atlas supports deployments on Base, Polygon, and Arbitrum, plus configured
Solana networks. This bridge currently advertises Arbitrum One (`eip155:42161`), Base (`eip155:8453`), Polygon (`eip155:137`), Solana mainnet (`solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp`).

1. Send the HTTP request without a payment signature.
2. Read the `402 Payment Required` response. Its `accepts` entries are the
   authoritative network, asset, amount, and recipient options for that call.
3. Select an option, sign it with an x402-compatible wallet or SDK, and repeat
   the request with the `PAYMENT-SIGNATURE` header. The successful response is
   returned after verification and settlement.

TypeScript clients can automate the challenge, signing, and retry flow with
[`x402-fetch`](https://www.npmjs.com/package/x402-fetch) or
[`x402-axios`](https://www.npmjs.com/package/x402-axios). Fund a dedicated
wallet only with the working USDC balance it needs and keep that key separate
from treasury accounts.

## Pricing

Atlas route prices start at $0.005 per successful call. This bridge's fallback
price is $0.005; operations below state their exact configured price in
`x-x402` and `x-payment-info`. The live `402` challenge remains authoritative.

## Worked payment example

Request one documented operation without a signature to inspect its live terms:

```bash
curl -i 'https://legal-entities.use.x402atlas.com/entity/5493001KJTIIGC8Y1R12'
# HTTP/1.1 402 Payment Required
# Read accepts[].network, asset, amount, and payTo from this response.
```

Sign one accepted option and repeat the identical request with the
`PAYMENT-SIGNATURE` header. Do not invent or cache payment terms; read them from
the current challenge.

## Use this API

- Interactive reference: https://legal-entities.use.x402atlas.com/docs
- OpenAPI 3.1 specification: https://legal-entities.use.x402atlas.com/openapi.json
- Agent-readable route corpus: https://legal-entities.use.x402atlas.com/llms.txt
- Endpoint index: https://legal-entities.use.x402atlas.com/index.json

Use the operation schemas and examples below to construct requests. Copy the
server URL, path, method, parameters, and request body from the operation you
want to call. Path and query examples are concrete and can be used directly.

## Atlas response metadata

Successful JSON responses include an additive top-level `_atlas` block, kept
separate from the bridge's data fields. `_atlas.docs` links this bridge's
`/llms.txt` corpus. `_atlas.related` suggests adjacent APIs, each with a callable
`url`, its own `docs` link, and a short `summary`. Suppress this block by sending
`X-Atlas-Meta: none` or by adding `?_atlas=0` to the request.

## Errors and compatibility

Validation failures use HTTP `400`. Paid operations may return `402` before
dispatch. Upstream and internal failures use the documented `5xx` responses.
Clients should rely on documented fields and tolerate additive response fields,
including `_atlas` unless they explicitly opt out.

## Protocol reference

- x402 protocol and SDKs: https://x402.org

## Global Legal Entities

Docs: https://legal-entities.use.x402atlas.com/docs · OpenAPI: https://legal-entities.use.x402atlas.com/openapi.json

### GET /entity/{lei}

Company lookup by Legal Entity Identifier (LEI) — retrieve legal name, jurisdiction, country, registration identifier, entity status and LEI renewal details. Identify counterparties and enrich company reference data.

Returns a company or legal entity’s registration profile by its Legal Entity Identifier (LEI), including legal name, jurisdiction, country, registration details and renewal dates.

Entity status and LEI registration status are separate: an active company can have a lapsed LEI registration. Use company search to find its LEI.

**Price:** $0.01 per call.

Parameters:
- `lei` (required path, string) — Omitted or empty LEI uses the example. Uppercase Legal Entity Identifier with valid MOD97 checksum. Find the LEI first with POST /search.; default: `"5493001KJTIIGC8Y1R12"`, minLength: `20`, maxLength: `20`, pattern: `"^[A-Z0-9]{18}[0-9]{2}$"`; example: `"5493001KJTIIGC8Y1R12"`

Example:

```sh
curl 'https://legal-entities.use.x402atlas.com/entity/5493001KJTIIGC8Y1R12'
```

Response example:

```json
{
  "entities": [
    {
      "country": "US",
      "entity_status": "ACTIVE",
      "jurisdiction": "US-DE",
      "last_updated": "2026-01-05T14:20:40Z",
      "legal_name": "Bloomberg Finance L.P.",
      "lei": "5493001KJTIIGC8Y1R12",
      "next_renewal": "2027-01-25T16:50:02Z",
      "registration_id": "4348344",
      "registration_status": "ISSUED"
    }
  ],
  "has_more": false,
  "operation": "entity",
  "page": 1,
  "page_size": 1,
  "parents": [],
  "schema_version": "1",
  "total": 1
}
```

### GET /parent-companies/{lei}

Parent company lookup by Legal Entity Identifier (LEI) — retrieve reported direct and ultimate accounting-consolidation parents, relationship statuses and reporting exceptions. Research corporate group structure and identify parent companies.

Returns an entity’s reported direct and ultimate accounting-consolidation parents—the companies that include it in their consolidated financial statements.

Includes the entity profile and up to ten records per parent category, with relationship details or reporting exceptions.

**Price:** $0.01 per call.

Parameters:
- `lei` (required path, string) — Omitted or empty LEI uses the example. Uppercase Legal Entity Identifier with valid MOD97 checksum. Find the LEI first with POST /search.; default: `"5493001KJTIIGC8Y1R12"`, minLength: `20`, maxLength: `20`, pattern: `"^[A-Z0-9]{18}[0-9]{2}$"`; example: `"5493001KJTIIGC8Y1R12"`

Example:

```sh
curl 'https://legal-entities.use.x402atlas.com/parent-companies/5493001KJTIIGC8Y1R12'
```

Response example:

```json
{
  "entities": [
    {
      "country": "US",
      "entity_status": "ACTIVE",
      "jurisdiction": "US-DE",
      "last_updated": "2026-01-05T14:20:40Z",
      "legal_name": "Bloomberg Finance L.P.",
      "lei": "5493001KJTIIGC8Y1R12",
      "next_renewal": "2027-01-25T16:50:02Z",
      "registration_id": "4348344",
      "registration_status": "ISSUED"
    }
  ],
  "has_more": false,
  "operation": "parent-companies",
  "page": 1,
  "page_size": 1,
  "parents": [
    {
      "kind": "direct",
      "records": [
        {
          "last_updated": "2026-01-05T14:20:40Z",
          "parent_id": "549300B56MD0ZC402L06",
          "parent_id_type": "LEI",
          "reason": null,
          "reference": null,
          "registration_status": "PUBLISHED",
          "relationship_status": "ACTIVE",
          "valid_from": "2026-01-06T00:00:00Z",
          "valid_to": null
        }
      ],
      "state": "relationship"
    },
    {
      "kind": "ultimate",
      "records": [
        {
          "last_updated": "2026-01-05T14:20:40Z",
          "parent_id": "549300RMUDWPHCUQNE66",
          "parent_id_type": "LEI",
          "reason": null,
          "reference": null,
          "registration_status": "PUBLISHED",
          "relationship_status": "ACTIVE",
          "valid_from": "2026-01-06T00:00:00Z",
          "valid_to": null
        }
      ],
      "state": "relationship"
    }
  ],
  "schema_version": "1",
  "total": 1
}
```

### POST /search

Company name search — find Legal Entity Identifiers (LEIs), legal names, jurisdictions and registration status. Get up to ten matches per page to identify counterparties, distinguish similarly named companies and enrich company reference data.

Finds legal entities by company name and returns their LEIs, jurisdictions and registration details. Use matches to select an entity for profile or parent-company lookup.

Each paid request returns up to ten matches. Page defaults to 1; pages 1–100 are supported.

**Price:** $0.01 per call.

Body fields:
- `page` (optional, integer) — Page number, starting at one.; default: `1`, minimum: `1`, maximum: `100`; example: `1`
- `query` (required, string) — Legal company name, 2..120 UTF-8 bytes; letters/digits/spaces and . & apostrophes ( ) - only; no '..' or filter operators. Empty/omitted query or body returns the fixed paid sample; page does not change it.; minLength: `2`, maxLength: `120`; example: `"Bloomberg"`

Request body (`application/json`):

```json
{
  "page": 1,
  "query": "Bloomberg"
}
```

Example:

```sh
curl --request POST 'https://legal-entities.use.x402atlas.com/search' --header 'Content-Type: application/json' --data '{"page":1,"query":"Bloomberg"}'
```

Response example:

```json
{
  "entities": [
    {
      "country": "US",
      "entity_status": "ACTIVE",
      "jurisdiction": "US-DE",
      "last_updated": "2022-11-21T00:05:30Z",
      "legal_name": "ABERDEEN STANDARD BLOOMBERG AGRICULTURE COMMODITY STRATEGY K-1 FREE ETF",
      "lei": "549300IKUTOEFVDBCD44",
      "next_renewal": "2022-11-20T00:00:00Z",
      "registration_id": "S000056191",
      "registration_status": "LAPSED"
    },
    {
      "country": "US",
      "entity_status": "ACTIVE",
      "jurisdiction": "US-DE",
      "last_updated": "2022-11-21T00:05:30Z",
      "legal_name": "ABERDEEN STANDARD BLOOMBERG ENERGY COMMODITY LONGER DATED STRATEGY K-1 FREE ETF",
      "lei": "549300OKZLYWADZ1DG13",
      "next_renewal": "2022-11-20T00:00:00Z",
      "registration_id": null,
      "registration_status": "LAPSED"
    }
  ],
  "has_more": true,
  "operation": "search",
  "page": 1,
  "page_size": 10,
  "parents": [],
  "schema_version": "1",
  "total": 220
}
```