Skip to main content

Documentation Index

Fetch the complete documentation index at: https://demircancelebi.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

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

FieldDescription
idNumeric document ID
disclosure_indexMKK’s own reference number for this filing
fund_codeThe fund this document belongs to
periodReporting period (e.g., "2023-Q3")
document_typeType of disclosure (e.g., quarterly, annual)
report_dateDate the report was filed
management_companyName of the fund’s management company
page_countTotal pages in the source PDF
parsed_pagesNumber of pages successfully parsed
pdf_urlDirect URL to the source PDF
kap_urlLink to the filing on the KAP public disclosure platform
kap_file_urlDirect file link on KAP
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: 
GET https://mkk-roan.vercel.app/api/documents/{docId}/pdf
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: 
GET https://mkk-roan.vercel.app/api/documents/42?include_raw=true
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

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

​
Example response: GET /documents/42

{
  "id": 42,
  "disclosure_index": "FCH2023Q3",
  "fund_code": "OJB",
  "file_name": "ojb_2023q3.pdf",
  "pdf_url": "https://mkk-roan.vercel.app/api/documents/42/pdf",
  "kap_url": "https://www.kap.org.tr/tr/Bildirim/1023456",
  "kap_file_url": "https://www.kap.org.tr/tr/BildirimPdf/1023456",
  "page_count": 12,
  "parsed_pages": 12,
  "document_type": "quarterly",
  "period": "2023-Q3",
  "report_date": "2023-10-15",
  "management_company": "Example Portföy A.Ş.",
  "line_item_values": [...],
  "portfolio_entries": [...],
  "totals": {...}
}

​
Filtering documents

You can filter documents by fund when listing: 
GET https://mkk-roan.vercel.app/api/documents?fund_code=OJB