Skip to main content
Documents are the core data objects in the MKK Structured Data API. Each document represents a single parsed PDF disclosure report filed by an investment fund with MKK or VYK. When you fetch a document, you get structured financial data extracted from that report — including key-value line items, portfolio holdings tables, and metadata that links back to the original filing.

​
What a document contains

Every document belongs to a fund and covers a single reporting period. The API parses each PDF and exposes the extracted data in two complementary forms:
  • line_item_values — structured key-value pairs mapping canonical financial metrics (e.g., net asset value, number of units) to their extracted values for that document. These are the primary way to access normalized, comparable data across funds and periods.
  • portfolio_entries — normalized rows from the fund’s holdings table, each representing a single security position with fields like ISIN, market value, and portfolio weight.
The document also exposes portfolio_rows — the raw table rows as parsed from the PDF, preserving the original column structure. Use portfolio_rows when you need the unmodified tabular data before normalization.

​
Key fields

kap_url and kap_file_url point to the original filing on the KAP (Public Disclosure Platform) system, which is Turkey’s official public filing portal. These links let you verify the source document or retrieve the original PDF directly from the filing authority. kap_url links to the filing’s detail page, while kap_file_url links directly to the downloadable file.

​
Accessing the source PDF

You can download the source PDF for any document using the dedicated endpoint:
This redirects to the pdf_url stored for the document.

​
Raw text and tables

By default, document responses omit raw text and raw table data to keep payloads small. Add include_raw=true to include them:
With include_raw=true, the response includes:
  • raw_text — the full extracted text from the PDF, page by page
  • tables — raw table structures parsed from each page
Raw text and table data can significantly increase response size. Only request include_raw=true when you need to inspect or reprocess the underlying PDF content.

​
Example requests

​
Example response: GET /documents/42

​
Filtering documents

You can filter documents by fund when listing: