API Reference
Filings
Filing history, latest filings, and filing detail.
Filings have both entity-scoped endpoints (filing history for a company) and globally-addressable endpoints (fetch any filing by ID). Every filing_id is globally unique.
Filing History
GET /v1/entities/{mei}/filingsReturns filing history for an entity, ordered by period_end descending.
| Parameter | Type | Required | Description |
|---|---|---|---|
form | string | no | Filter by form type (10-K, 10-Q, 8-K, etc.) |
limit | int | no | Max results (default 20, max 100) |
after | date | no | Only filings with period_end after this date |
{
"mei": "MNKSSGMDJMN22",
"filings": [
{
"id": "01jqx...",
"form": "10-K",
"fy": 2024,
"fp": "FY",
"period_start": "2023-09-25",
"period_end": "2024-09-28",
"issued_at": "2024-11-01T00:00:00Z",
"source_system": "sec_edgar",
"source_filing_id": "0000320193-24-000123"
}
]
}Latest Filing
GET /v1/entities/{mei}/filings/latestReturns the most recent filing for an entity, optionally constrained to a specific form.
| Parameter | Type | Required | Description |
|---|---|---|---|
form | string | no | Filing form filter (10-K, 10-Q, 8-K, etc.) |
Filing Detail
GET /v1/filings/{filing_id}Returns metadata for one filing plus direct artifact URLs when available.
{
"filing": {
"id": "01jqx...",
"mei": "MNKSSGMDJMN22",
"form": "10-K",
"fy": 2024,
"fp": "FY",
"period_end": "2024-09-28",
"issued_at": "2024-11-01T00:00:00Z",
"edgar_url": "https://www.sec.gov/Archives/edgar/data/...",
"odoc_url": "https://objects.hermaeus.dev/filings/01jqx.odoc",
"sheet_url": "https://objects.hermaeus.dev/filings/01jqx.osx"
}
}odoc_url and sheet_url are signed object-store URLs with a 15-minute TTL. Re-fetch the filing detail endpoint to get fresh URLs. These fields may be null for filings not yet materialized into Hermaeus-native formats.