API Reference
Financials
Financial time series, filing drilldowns, and summaries.
Financial data in Hermaeus is filing-native — every fact traces back to the specific filing it was reported in. The API exposes this grain directly for time-series and drilldown queries.
Time Series
GET /v1/entities/{mei}/financialsReturns historical financial facts for specified concepts, ordered by most recent period_end descending.
| Parameter | Type | Required | Description |
|---|---|---|---|
concepts | string | no | Comma-separated concept IDs (e.g. REVENUE,NET_INCOME). Defaults to REVENUE, NET_INCOME, TOTAL_ASSETS, OPERATING_CASH_FLOW. |
periods | int | no | Number of most recent periods per concept (default 8) |
period_kind | string | no | annual or quarterly. Default: all. |
after | date | no | Only periods ending after this date |
{
"mei": "MNKSSGMDJMN22",
"facts": [
{
"id": "01jqx...",
"concept_id": "REVENUE",
"period_start": "2023-09-25",
"period_end": "2024-09-28",
"fy": 2024,
"fp": "FY",
"val": 391035000000,
"unit": "USD",
"filing_id": "01jqx..."
}
]
}Every fact carries its filing_id — you can always trace a number back to the source filing.
Filing Drilldown
GET /v1/entities/{mei}/filings/{filing_id}/financialsReturns all financial facts reported in a specific filing.
| Parameter | Type | Required | Description |
|---|---|---|---|
concepts | string | no | Filter to specific concepts |
{
"mei": "MNKSSGMDJMN22",
"filing": {
"id": "01jqx...",
"form": "10-K",
"fy": 2024,
"fp": "FY",
"period_end": "2024-09-28",
"issued_at": "2024-11-01T00:00:00Z"
},
"facts": [
{
"id": "01jqx...",
"concept_id": "REVENUE",
"period_start": "2023-09-25",
"period_end": "2024-09-28",
"val": 391035000000,
"unit": "USD"
}
]
}Summary
GET /v1/entities/{mei}/financials/summaryReturns the latest comparable values for a curated set of key financial metrics.
| Parameter | Type | Required | Description |
|---|---|---|---|
period_kind | string | no | annual or quarterly. Default: annual. |
{
"mei": "MNKSSGMDJMN22",
"as_of_filing": "01jqx...",
"period_kind": "annual",
"period_end": "2024-09-28",
"metrics": {
"REVENUE": { "val": 391035000000, "unit": "USD" },
"NET_INCOME": { "val": 93736000000, "unit": "USD" },
"EPS_DILUTED": { "val": 6.08, "unit": "USD/shares" },
"TOTAL_ASSETS": { "val": 364980000000, "unit": "USD" }
}
}Taxonomy
Use GET /v1/taxonomy/concepts to discover available concept IDs and their coverage. See Taxonomy.