Python SDK

We provide an official, production-ready Python client to simplify interacting with the FinancialReports API. It handles authentication, retries, and data validation automatically.

Installation

The package is hosted on PyPI and supports Python 3.7+.

Quick Start

The SDK uses asyncio for high-performance, non-blocking data retrieval—ideal for processing large volumes of filings or building real-time dashboards.

1. Basic Setup

You can provide your API Key directly to the constructor, or set it as an environment variable FINANCIAL_REPORTS_API_KEY to keep your code clean.

Common Scenarios

Filtering & Searching

The client supports all API filters as named arguments.

Downloading Files

To retrieve the processed Markdown content of a filing:

Accessing Reference Data

Retrieve standardized industry classifications (ISIC) or supported countries.

Error Handling

The SDK raises specific exceptions from financial_reports_generated_client.exceptions to help you handle failures gracefully.

Access Levels

Your API key's access permissions determine which data you can retrieve.

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.).

Installation#

Quick Start#

1. Basic Setup#

Common Scenarios#

Filtering & Searching#

Downloading Files#

Accessing Reference Data#

Error Handling#

Access Levels#