Metadata-Version: 2.4
Name: financial_reports_generated_client
Version: 1.4.34
Summary: FinancialReports API
Home-page: 
Author: API Support
Author-email: API Support <api@financialreports.eu>
License: Apache-2.0
Project-URL: Repository, https://github.com/GIT_USER_ID/GIT_REPO_ID
Keywords: OpenAPI,OpenAPI-Generator,FinancialReports API
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: python-dateutil>=2.8.2
Requires-Dist: aiohttp>=3.8.4
Requires-Dist: aiohttp-retry>=2.8.3
Requires-Dist: pydantic>=2.11
Requires-Dist: typing-extensions>=4.7.1
Dynamic: author

# Financial Reports Python SDK

The official Python client for the [FinancialReports API](https://financialreports.eu). 

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

## Installation

```bash
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`.

```python
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://financialreports.eu/docs](https://financialreports.eu/docs)
* **Support:** [support@financialreports.eu](mailto:support@financialreports.eu)

---
*Generated by FinancialReports Engineering.*
