API Documentation
← All tools
GET/api/v1/tools/financials/lei-to-ticker

LEI to Ticker

financials

Map a Legal Entity Identifier (LEI) to its SEC ticker(s). Returns the LEI entity's name plus data.secEntities - one row per mapped SEC entity ({ticker, cik, name}); a single LEI can map to several SEC listings (e.g. share classes), so treat the array as the complete mapping. Use this as the bridge from an LEI (e.g. a sponsors_chain canonical LEI id, the lei field of Financial Metrics, or a Sponsor Profile identity) to ticker-based tools: Financial Metrics and Sponsor Profile. A 404 means no SEC ticker mapping exists - the entity may be privately held, not publicly traded, or not yet resolved; it does NOT mean the LEI is invalid or unknown. Malformed LEIs (not exactly 20 alphanumeric characters) return HTTP 400. This endpoint carries NO financial data itself - call Financial Metrics with a returned ticker for that.

When to use it

  • resolve an LEI to a public SEC ticker before pulling financials
  • check whether a company identified by LEI is publicly traded

Getting started

Base URL

https://app.caelrith.com/api/v1/tools

Authentication

Include your API key in the x-api-key header.

Parameters

Query parameters

ParameterTypeRequiredDescription
leistringYes20-character alphanumeric LEI (case-insensitive; uppercased automatically). Not exactly 20 alphanumeric characters returns HTTP 400.

Example request

curl -H "x-api-key: YOUR_API_KEY" \
  "https://app.caelrith.com/api/v1/tools/financials/lei-to-ticker?lei=your_lei"

Response envelope

Successful responses wrap the payload in a success flag.

{
  "success": true,
  "data": { /* payload */ },
  "meta": { /* pagination, totals */ }
}

Response shape

List responseSEC_ENTITIES

Payload: data.secEntities — SEC Entities

Common row fields

FieldDescription
tickerRecord identifier
nameMain display field
cik—

Empty results: No record found (HTTP 404) (HTTP 404: no SEC ticker mapping for this LEI - the entity may be privately held, not publicly traded, or not yet resolved; NOT evidence the LEI is invalid)

Bridge tool: LEI -> ticker(s); carries NO financial data itself. data.secEntities rows ({ticker, cik, name}) are the complete mapping (no pagination / cap; multiple rows are possible for multiple listings). Each row's ticker is directly usable with Financial Metrics and Sponsor Profile.

Catalog version 0.0.0-generated · generated from the API source