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 FINANCIAL_REPORTS_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.
1 maintainer
Metadata
1 maintainer
Release files for financial-reports-generated-client 1.4.83
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| financial_reports_generated_client-1.4.83.tar.gz | 113.5 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| financial_reports_generated_client-1.4.83-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 383.9 kB
Release files / financial_reports_generated_client-1.4.83.tar.gz
| Download URL | financial_reports_generated_client-1.4.83.tar.gz |
|---|---|
| Size | 113.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
689842c068959aa8eeb1ec37edeb6b2a8a70fa17619932d031d5e93c270d4aa7
|
|
BLAKE2b-256 checksum How to use checksums |
120cdbb55eff9bb34347a3b7bf9ab5e7c90d0c1953579386730a3cb3a0fef951
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / financial_reports_generated_client-1.4.83-py3-none-any.whl
| Download URL | financial_reports_generated_client-1.4.83-py3-none-any.whl |
|---|---|
| Size | 270.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
ed8de06ab9a7b2ec17b5dc2d11c5479aaf919a646e38ebd4800def7a170d289d
|
|
BLAKE2b-256 checksum How to use checksums |
f8a80dc9b4c594ee10b1c066b5f34aaa45909f83b2ca3be334b6976f405c1f79
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
