Overview

The FinIQ Filings API provides a normalized stream of corporate disclosures from 60+ global exchanges. We ingest, parse, and standardize documents from EDGAR (US), Companies House (UK), SEDAR (Canada), and others into a single filing object, enabling seamless cross-border analysis.

Key Capabilities:

• Normalization: Global documents mapped to US equivalents (10-K, 10-Q, 8-K).
• Extraction: Automated parsing of "Risk Factors" and "MD&A" sections.
• Translation: Neural translation for non-English filings.
• Format: Clean JSON output with links to original PDFs.

‍

1. Access Methods

‍

2. REST API: Filings Endpoint

Endpoint: GET https://api.finiq.data/v1/filings

Request Parameters:

‍

Example Request (Python)

import requests

url = "https://api.finiq.data/v1/filings"
params = {
    "api_token": "YOUR_KEY",
    "ticker": "VOD.L",
    "type": "annual",
    "extract_section": "risk_factors"
}

response = requests.get(url, params=params)
data = response.json()

‍

Response Structure (JSON)

{
  "ticker": "VOD.L",
  "exchange": "LSE",
  "filing_type": "Annual_Report",
  "mapped_type": "10-K_Equivalent",
  "period_end": "2024-03-31",
  "filing_date": "2024-05-21",
  "source_url": "https://filings.finiq.data/lse/vod/2024_annual.pdf",
  "section_data": {
    "section_name": "risk_factors",
    "word_count": 4500,
    "sentiment_score": -0.45,
    "text": "The Group faces regulatory risks in the German market..."
  }
}

‍

‍

3. Global Normalization Map

We standardizes regional regulatory codes into a unified taxonomy.

‍

4. Bulk Data Access (JSONL)

Download the complete global corpus for LLM training.

File Naming Convention:{Region}_Filings_{Type}_{Year}.jsonl

Format:One JSON object per line. Ideal for streaming large datasets.

How to Download:

1. Navigate to Data Export.
2. Select Filings Package.
3. Choose Region (e.g. "EMEA") and Document Type (e.g. "Annual").
4. Click Download ZIP.

‍

5. Vector Database Feed (RAG-Ready)

Exclusive to FinIQ.Search the filings universe using natural language.

Sample Vector Output (Decoded):

"Context: Vodafone Group Annual Report 2024. Section: Risk Factors. Text: 'Post-Brexit data privacy divergence remains a key operational risk for our EU-UK data transfers.'"

Use Case:

• "Find all automotive companies listing 'Lithium Shortage' as a risk factor."
• "Compare the 'Cybersecurity' disclosures of US Banks vs. UK Banks."

‍

6. Error Handling

• 400 Bad Request: Invalid Ticker or Type.
• 401 Unauthorized: Invalid API Key.
• 404 Not Found: Filing unavailable.
• 429 Too Many Requests: Rate limit exceeded.

‍

7. Need Help?

• Developer Support: email dev-support@finiq.data
• Slack Community: Join our [Quant Developer Slack]