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.

The health endpoints give you a quick way to verify that the API is online and to inspect the current size of the indexed dataset. Both GET / and GET /health return the same HealthResponse object, so you can use either path as a liveness probe in your monitoring stack.

​
Endpoints

MethodPathDescription
GET/healthReturns API status and dataset counts
GET/Alias for GET /health
Base URL: https://mkk-roan.vercel.app/api

​
GET /health

Returns a HealthResponse confirming the service is running along with aggregate counts for each major collection in the database.
GET / and GET /health are identical. Use whichever path is more convenient for your health check setup.

​
Response schema

​
status
string
required
Always "ok" when the service is healthy.
​
documents
integer
required
Total number of parsed fund disclosure documents in the database.
​
funds
integer
required
Total number of distinct funds tracked across all documents.
​
sections
integer
required
Total number of canonical sections defined in the schema.
​
line_items
integer
required
Total number of canonical line item definitions.
​
line_item_values
integer
required
Total number of extracted line item values across all documents.
​
portfolio_entries
integer
required
Total number of normalized portfolio entries across all documents.
​
portfolio_rows
integer
required
Total number of raw portfolio table rows extracted from documents.

​
Example request

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

​
Example response

200
{
  "status": "ok",
  "documents": 4821,
  "funds": 312,
  "sections": 47,
  "line_items": 198,
  "line_item_values": 891430,
  "portfolio_entries": 2347610,
  "portfolio_rows": 2401088
}

​
GET /openapi.json

Returns the full OpenAPI specification document describing every endpoint in the MKK Structured Data API.
You can import the OpenAPI document into tools like Postman, Insomnia, or any OpenAPI-compatible client to explore and test the API interactively.

​
Example request

curl https://mkk-roan.vercel.app/api/openapi.json