API Reference

Entities

Look up, search, and resolve entities.

Entities are the primary navigation root in Hermaeus. Every public company, subsidiary, and related organization has a canonical MEI (Master Entity Identifier). All entity-scoped endpoints use the MEI as the path parameter.

Lookup

GET /v1/entities/{mei}

Returns the canonical entity record with cross-referenced metadata.

{
  "mei": "MNKSSGMDJMN22",
  "kind": "organization",
  "status": "active",
  "names": [
    { "name": "Apple Inc.", "created_at": "2026-03-15T00:00:00Z" }
  ],
  "identifiers": [
    { "system": "cik", "value": "0000320193" },
    { "system": "lei", "value": "HWUPKR0MPOU8FGXBT394" }
  ],
  "organization": {
    "sic_code": "3571",
    "sic_description": "Electronic Computers",
    "jurisdiction": "US-CA",
    "status": "active"
  }
}

Overview

GET /v1/entities/{mei}/overview

Returns a bounded briefing view for an entity: canonical identity, a latest financial snapshot, and recent filings.

{
  "entity": {
    "mei": "MNKSSGMDJMN22",
    "name": "Apple Inc.",
    "kind": "organization",
    "ticker": "AAPL",
    "cik": "0000320193"
  },
  "financial_summary": {
    "period_kind": "annual",
    "period_end": "2024-09-28",
    "metrics": {
      "REVENUE": { "val": 391035000000, "unit": "USD" },
      "NET_INCOME": { "val": 93736000000, "unit": "USD" }
    }
  },
  "latest_filings": [
    {
      "id": "01jqx...",
      "form": "10-K",
      "period_end": "2024-09-28",
      "issued_at": "2024-11-01T00:00:00Z"
    }
  ]
}
GET /v1/entities/search?q={query}&limit={n}

Search by name or by exact identifier. Exactly one of q or (system, identifier) must be supplied.

ParameterTypeRequiredDescription
qstringnoSearch term for discovery by entity name
systemstringnoIdentifier system for exact lookup (cik, lei, ticker, etc.)
identifierstringnoExact identifier value when system is supplied
limitintnoMax results (default 10, max 100)
# Search by name
curl -H "x-api-key: sk_..." \
  "https://api.hermaeus.xyz/v1/entities/search?q=Apple"

# Search by identifier
curl -H "x-api-key: sk_..." \
  "https://api.hermaeus.xyz/v1/entities/search?system=cik&identifier=0000320193"

Resolve

GET /v1/entities/resolve?system={system}&identifier={value}

Resolve a single external identifier to its canonical MEI. Returns 404 if not found.

{
  "mei": "MNKSSGMDJMN22",
  "system": "cik",
  "identifier": "0000320193"
}

Clients should persist the returned MEI and use it for all subsequent entity-scoped requests.

On this page

LookupOverviewSearchResolve