How do I convert a KID or factsheet PDF to JSON?

The call

bash
# A PDF you have
curl -s -X POST https://fundfactsapi.com/api/v1/extract -H "Authorization: Bearer $FUNDFACTS_API_KEY" -F "file=@kid.pdf"
​
# A public URL
curl -s -X POST https://fundfactsapi.com/api/v1/extract -H "Authorization: Bearer $FUNDFACTS_API_KEY" \
  -H "Content-Type: application/json" -d '{"url":"https://example.com/documents/factsheet.pdf"}'

python
import os, requests
with open("factsheet.pdf", "rb") as f:
    r = requests.post("https://fundfactsapi.com/api/v1/extract", headers={"Authorization": f"Bearer {os.environ['FUNDFACTS_API_KEY']}"}, files={"file": f}, timeout=300)
d = r.json()["data"]
print(d["keyFacts"], d["headlineMetrics"]["ter"], d["riskRating"], d["costs"], d["topHoldings"][:5], d["dataAsOf"])

What it reads

• KID / KIID: name, ISIN, risk indicator, cost table (entry, exit, ongoing, transaction, performance fee, reduction in yield, recommended holding period), SFDR article, objective text, in six languages with regex rules, then the document model for anything the rules did not catch.
• Factsheet: key facts, TER, top holdings, sector / country / asset tables, calendar and annualised returns, portfolio characteristics.

The output shape is identical to GET /funds/{isin}, so one renderer or one database schema handles both sources. Fields the document does not print are empty, not guessed.

When to use it

• The fund house is not among the covered issuers yet.
• You receive documents from clients or counterparties rather than fetching them.
• You need a specific historical document (last year's KID) rather than the current one.

For covered funds, GET /funds/{isin} is cheaper (one request instead of five) and adds the holdings file and the NAV-based series that a single PDF cannot provide.

Limits

Scanned images without a text layer are not read. Documents are processed on the fly and are not kept. Five requests per document; Pro and above. The UCITS KID explained for developers describes the document structure the parser relies on.