Funds are the primary organizing unit of the MKK Structured Data API. Each fund represents a named investment fund registered in the MKK system, and every document, line item value, and portfolio entry you retrieve is scoped to a specific fund. You use funds as the starting point for most queries — either to browse all available funds or to drill into a single fund’s historical disclosures.
What a fund is
A fund in the MKK API corresponds to a real investment fund that files periodic disclosure reports with MKK. Each fund has a human-readable fund_title and a short fund_code that serves as its primary identifier throughout the API.
The fund_code identifier
The fund_code is a short alphanumeric string (e.g., "OJB") that uniquely identifies a fund. You can use fund_code as a path parameter or query filter anywhere the API accepts a fund reference. In most cases, fund_code is more convenient than the numeric id because it is stable, memorable, and visible in MKK filings.
Use fund_code (e.g., ?fund_code=OJB) in query parameters rather than fund_id when filtering related resources like line item values or portfolio entries. Both work, but fund_code is easier to read and less likely to change across environments.
Periods
Each fund has a first_period and last_period that indicate the earliest and most recent reporting periods available in the API. Periods follow a consistent string format (e.g., "2023-Q3") and are used to filter documents and line item values across time. The period_count field tells you how many distinct periods are available for a fund.
What a fund response includes
A fund detail response includes aggregate counts that tell you how much data is available before you fetch child resources:
Example requests
Example response: GET /funds/OJB
What you can access from a fund
Once you have a fund_code, you can retrieve:
- Documents — the individual parsed PDF reports filed by the fund (
/documents?fund_code=OJB)
- Sections — the canonical report sections available for the fund (
/sections?fund_code=OJB)
- Line item values — structured financial metrics extracted from each report (
/line-item-values?fund_code=OJB)
- Portfolio entries — normalized holdings tables from the fund’s disclosures (
/portfolio-entries?fund_code=OJB)
