Skip to main content
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:
FieldDescription
idNumeric database ID
fund_codeShort identifier (e.g., "OJB")
fund_titleFull fund name
document_countNumber of parsed disclosure documents
period_countNumber of distinct reporting periods
line_item_countNumber of distinct line items extracted
first_periodEarliest available period
last_periodMost recent period

​
Example requests

curl https://mkk-roan.vercel.app/api/funds

​
Example response: GET /funds/OJB

{
  "id": 12,
  "fund_code": "OJB",
  "fund_title": "OJB Değişken Fon",
  "document_count": 48,
  "period_count": 16,
  "line_item_count": 94,
  "first_period": "2019-Q1",
  "last_period": "2023-Q4"
}

​
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)