FinancialFilings Python SDK

The official Python client for the FinancialFilings API.

Access a comprehensive database of financial filings, company information, and industry classifications programmatically.

Installation

pip install financial-reports-generated-client

Quick Start

The SDK is designed to be simple and intuitive. It uses asyncio for high-performance data retrieval.

1. Initialize the Client

You can pass your API key directly or set it as an environment variable FR_API_KEY.

import asyncio
from financial_reports_generated_client import FinancialReports

async def main():
    # Context manager automatically handles cleanup
    async with FinancialReports(api_key="YOUR_API_KEY") as client:
        
        # --- Example 1: List Filings ---
        # Get the latest filings, searching for "Volkswagen"
        filings = await client.filings.list(
            search="Volkswagen", 
            ordering="-release_datetime",
            page_size=5
        )
        
        for filing in filings.results:
            print(f"{filing.release_datetime}: {filing.title} ({filing.company.name})")

        # --- Example 2: Get Company Details ---
        # Fetch detailed profile for a specific company ID
        company = await client.companies.retrieve(id=123)
        print(f"Company: {company.name}, Country: {company.country_code}")

if __name__ == "__main__":
    asyncio.run(main())

Access Levels

The API response data depends on your subscription tier.

Level	Name	Description
Level 1	Standard Access	Access to raw PDF/XBRL metadata, company profiles, ISIC classifications, and reference data.
Level 2	Processed Filings	Access to converted content (Markdown/JSON) and full-text search capabilities.
Level 3	Extracted Financials	Access to specific extracted financial line items (Revenue, EBITDA, etc.).

Documentation

Full API Reference: https://financialfilings.com/docs
Support: support@financialreports.eu

Generated by FinancialFilings Engineering.

Metadata

Release files for financial-reports-generated-client 1.4.101

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for financial-reports-generated-client 1.4.101
File	Size	Uploaded
financial_reports_generated_client-1.4.101.tar.gz	124.1 kB	Oct 2, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for financial-reports-generated-client 1.4.101
File	Interpreter	ABI	Platform	Reset
financial_reports_generated_client-1.4.101-py3-none-any.whl 288.0 kB Oct 2, 2026	Python 3	none	any	Details

Total release size: 412.0 kB

Release files / financial_reports_generated_client-1.4.101.tar.gz

Download URL	financial_reports_generated_client-1.4.101.tar.gz
Size	124.1 kB
Tags	Source
SHA-256 checksum How to use checksums	`47168e307d1b7074cf575c0bc17d9da285b2992afa37ab155dd1a1e510afa1b6`
BLAKE2b-256 checksum How to use checksums	`ad59f079f2ad3f5396443c9c227bb028746c1722e5ccdb2ac831b986b7d63b47`
Upload date	Oct 2, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/financial-reports/web
Publishing commit: github.com/financial-reports/web/tree/c8fb021045433565b7b34ef7c91da1e4c2ddd261

Workflow

Publishing configuration: github.com/financial-reports/web/blob/c8fb021045433565b7b34ef7c91da1e4c2ddd261/.github/workflows/generate_sdks.yml
Publishing logs: github.com/financial-reports/web/actions/runs/37016618609/attempts/1

Artifact

Subject: financial_reports_generated_client-1.4.101.tar.gz
SHA-256 checksum: 47168e307d1b7074cf575c0bc17d9da285b2992afa37ab155dd1a1e510afa1b6 Verifying attestations

Release files / financial_reports_generated_client-1.4.101-py3-none-any.whl

Download URL	financial_reports_generated_client-1.4.101-py3-none-any.whl
Size	288.0 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`775601a7d4c232b0063249f3f26372ec6718a23853d2186e39f39bf242311821`
BLAKE2b-256 checksum How to use checksums	`45ba4e541cdac0f707fa829c0db53a18ac13f3b232fb6375dcb8b13aad7ec458`
Upload date	Oct 2, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/financial-reports/web
Publishing commit: github.com/financial-reports/web/tree/c8fb021045433565b7b34ef7c91da1e4c2ddd261

Workflow

Publishing configuration: github.com/financial-reports/web/blob/c8fb021045433565b7b34ef7c91da1e4c2ddd261/.github/workflows/generate_sdks.yml
Publishing logs: github.com/financial-reports/web/actions/runs/37016618609/attempts/1

Artifact

Subject: financial_reports_generated_client-1.4.101-py3-none-any.whl
SHA-256 checksum: 775601a7d4c232b0063249f3f26372ec6718a23853d2186e39f39bf242311821 Verifying attestations