Introduction

Hermaeus reads SEC filings and other authoritative sources, resolves them into one coherent identity graph, and exposes it as a REST API. The dataset spans public companies, their subsidiaries, officers, directors, and every document they file — 10-Ks, 10-Qs, 8-Ks, proxy statements, beneficial ownership reports, and more.

Every entity gets a canonical identifier called an MEI. Every financial fact carries a reference to the filing it was extracted from. The result is a single graph where you can move fluidly between an entity, its filings, and the structured data inside them — without stitching together multiple vendors or reconciling conflicting identifiers.

One key, one base URL, every filing.

Core concepts

Entities are the primary navigation root. Companies, people, and organizations are all entities with a stable MEI. Use entity search to find them by name, ticker, or CIK — then use the MEI for everything else. Entities are cross-linked: a company entity connects to its officers, subsidiaries, and related persons, so you can traverse the graph from any starting point.

Filings are the source of truth. 10-K, 10-Q, 8-K, 13D, 13G, and more. Every filing is globally addressable by ID and linked to the entity that filed it. You can retrieve filing metadata, download the original document artifacts, or drill into the structured data extracted from each filing.

Financials are filing-native. Revenue, net income, assets, cash flow — extracted from XBRL, stored at the filing grain. Every number carries its filing_id so you can always trace it back to the source. Query time series across periods, or drill into a single filing to see exactly what was reported.

Taxonomy defines the concept catalog. Financial metrics are organized into a structured taxonomy of concepts. Use the taxonomy endpoint to discover what metrics are available, what they mean, and how broadly they're covered across the dataset — before you write a single query.

Quick start

Get an API key from app.hermaeus.xyz and make your first request:

curl -H "x-api-key: sk_your_key_here" \
  "https://api.hermaeus.xyz/v1/entities/search?q=apple"

See Getting Started for a full walkthrough.