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.

Sections represent the canonical, normalized groupings into which line items are classified across all MKK fund disclosure documents. Because raw documents use varied heading conventions, the API maps each raw section label to a single canonical section (identified by its sectionId slug). You can use section filters on the line-items and line-item-values endpoints to narrow results to a specific area of a fund’s financial statements.

​
Endpoints

MethodPathDescription
GET/sectionsList all canonical sections
GET/sections/{sectionId}Retrieve detail for a single section
Base URL: https://mkk-roan.vercel.app/api

​
GET /sections

Returns the full list of canonical sections, with optional filtering by fund or free-text search.

​
Query parameters

​
fund_id
string
Filter sections to those that appear in documents belonging to the fund with this internal database ID.
​
fund_code
string
Filter sections to those that appear in documents belonging to the fund with this fund code (e.g., OJB). Use this instead of fund_id when you know the fund code.
​
q
string
Free-text search against section names. Returns sections whose name contains the query string (case-insensitive).

​
Response schema

​
sections
SectionSummary[]
required
Array of canonical section summary objects.

​
Example requests

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

​
Example response

200
{
  "sections": [
    {
      "id": "sec_01",
      "sectionId": "net-asset-value",
      "name": "Net Asset Value",
      "sort_order": 1,
      "line_item_count": 12,
      "document_count": 4650,
      "fund_count": 298
    },
    {
      "id": "sec_02",
      "sectionId": "portfolio-distribution",
      "name": "Portfolio Distribution",
      "sort_order": 2,
      "line_item_count": 31,
      "document_count": 3820,
      "fund_count": 241
    }
  ]
}

​
GET /sections/

Returns detailed information for a single canonical section, including all line items belonging to it.

​
Path parameters

​
sectionId
string
required
The canonical slug for the section (e.g., net-asset-value). This corresponds to the sectionId field returned by GET /sections.

​
Query parameters

​
fund_id
string
Restrict the returned line_items to those that appear in documents for the fund with this internal ID.
​
fund_code
string
Restrict the returned line_items to those that appear in documents for the fund with this fund code (e.g., OJB).
​
include_values
string
When set to a truthy value (1, true, yes, or on), each line item in the line_items array includes its extracted values array. Omit for lighter responses when you only need the line item metadata.

​
Response schema

SectionDetail extends SectionSummary with:
​
id
string
required
Internal database identifier.
​
sectionId
string
required
Canonical slug.
​
name
string
required
Human-readable name.
​
sort_order
integer
required
Display sort order.
​
line_item_count
integer
required
Number of line items in this section.
​
document_count
integer
required
Number of documents with data in this section.
​
fund_count
integer
required
Number of funds with data in this section.
​
line_items
LineItem[]
required
Full array of canonical line items belonging to this section. When include_values is truthy, each line item also includes a values array of extracted values. See the Line Items reference for the full LineItem schema.

​
Error responses

StatusDescription
404No section with the given sectionId slug exists.

​
Example requests

curl https://mkk-roan.vercel.app/api/sections/net-asset-value

​
Example response

200
{
  "id": "sec_01",
  "sectionId": "net-asset-value",
  "name": "Net Asset Value",
  "sort_order": 1,
  "line_item_count": 12,
  "document_count": 4650,
  "fund_count": 298,
  "line_items": [
    {
      "id": "li_001",
      "slug": "total-net-assets",
      "name": "Total Net Assets",
      "sectionId": "net-asset-value",
      "sectionName": "Net Asset Value",
      "unit": "TRY",
      "kind": "metric",
      "value_count": 4412,
      "fund_count": 289,
      "document_count": 4412
    }
  ]
}
404
{
  "error": "Section not found",
  "sectionId": "unknown-section"
}