The export endpoints let you download large slices of the MKK dataset as CSV files without pagination. Each endpoint accepts the same filter parameters as its JSON counterpart, plus anDocumentation Index
Fetch the complete documentation index at: https://demircancelebi.mintlify.app/llms.txt
Use this file to discover all available pages before exploring further.
export_limit parameter that controls the maximum number of rows returned (up to 100,000). Use these endpoints when you need to load data into a spreadsheet, data warehouse, or analytical pipeline.
Endpoints
| Method | Path | Description |
|---|---|---|
GET | /exports/portfolio-entries.csv | Export normalized portfolio holdings as CSV |
GET | /exports/line-item-values.csv | Export extracted line item values as CSV |
GET | /exports/data-quality.csv | Export data quality report entries as CSV |
https://mkk-roan.vercel.app/api
Filter parameter reference
The table below shows which filter parameters apply to each export endpoint.| Parameter | portfolio-entries.csv | line-item-values.csv | data-quality.csv |
|---|---|---|---|
fund_id | Yes | Yes | Yes |
fund_code | Yes | Yes | Yes |
period | Yes | Yes | — |
document_id | Yes | Yes | — |
section | Yes | — | — |
section_id | — | Yes | — |
line_item_slug | — | Yes | — |
q | Yes | Yes | — |
label | — | Yes | — |
low_line_item_threshold | — | — | Yes |
export_limit | Yes | Yes | Yes |
offset | Yes | Yes | — |
GET /exports/portfolio-entries.csv
Exports normalized portfolio holdings matching the applied filters. Equivalent to the JSON/portfolio-entries endpoint but returns CSV with up to 100,000 rows.
Query parameters
Filter to holdings from the fund with this internal ID.
Filter to holdings from the fund with this fund code (e.g.,
OJB).Filter to holdings from documents for this reporting period in
YYYY-MM format.Filter to holdings from a specific document by its numeric ID.
Filter to holdings in a specific portfolio section label.
Free-text search across security names, ISINs, and issuer names.
Maximum number of rows to include in the export. Accepts values from
1 to 100000. The default is 50000.Number of rows to skip before exporting. Use with
export_limit to page through datasets larger than 100,000 rows.Example request
GET /exports/line-item-values.csv
Exports extracted line item values matching the applied filters as CSV. Equivalent to the JSON/line-item-values endpoint but returns up to 100,000 rows.
Query parameters
Filter to values from the fund with this internal ID.
Filter to values from the fund with this fund code (e.g.,
OJB).Filter to values from documents for this reporting period in
YYYY-MM format.Filter to values from a specific document by its numeric ID.
Filter to values belonging to the canonical section with this slug.
Filter to values for the canonical line item with this slug (e.g.,
total-net-assets).Free-text search across value labels and line item names.
Filter by the raw label as it appeared in the source document.
Maximum number of rows to include. Accepts values from
1 to 100000.Number of rows to skip before exporting.
Example request
GET /exports/data-quality.csv
Exports data quality report entries as CSV. Equivalent to the JSON/data-quality endpoint but returns the report’s list entries (low-line-item documents, empty documents, and so on) as flat rows.
Query parameters
Scope the quality report to the fund with this internal ID.
Scope the quality report to the fund with this fund code (e.g.,
OJB).Documents with fewer than this many extracted line items are flagged in the low-line-item queue. Accepts values from
0 to 100.Maximum number of rows to include. Accepts values from
1 to 100000.Example request
Working with large datasets
The maximumexport_limit is 100,000 rows per request. If your dataset is larger, use offset to page through it in batches.
To download all portfolio entries for a fund with more than 100,000 rows, issue sequential requests with increasing offsets: