Skip to main content

Financial Reports API

Project description

financial-reports-generated-client

Welcome to the Financial Reports API, your gateway to European company filings, financial data, and corporate information. All API requests must be authenticated. Authentication is performed by including your unique API key in the X-API-Key HTTP header. Please use the "Authorize" button to set your key and try out the endpoints.

This Python package is automatically generated by the OpenAPI Generator project:

  • API version: 1.0.0
  • Package version: 1.3.3
  • Generator version: 7.18.0-SNAPSHOT
  • Build package: org.openapitools.codegen.languages.PythonClientCodegen For more information, please visit https://financialreports.eu/

Requirements.

Python 3.9+

Installation & Usage

pip install

If the python package is hosted on a repository, you can install directly using:

pip install git+https://github.com/GIT_USER_ID/GIT_REPO_ID.git

(you may need to run pip with root permission: sudo pip install git+https://github.com/GIT_USER_ID/GIT_REPO_ID.git)

Then import the package:

import financial_reports_generated_client

Setuptools

Install via Setuptools.

python setup.py install --user

(or sudo python setup.py install to install the package for all users)

Then import the package:

import financial_reports_generated_client

Tests

Execute pytest to run the tests.

Getting Started

Please follow the installation procedure and then run the following:

import financial_reports_generated_client
from financial_reports_generated_client.rest import ApiException
from pprint import pprint

# Defining the host is optional and defaults to https://api.financialreports.eu
# See configuration.py for a list of all supported configuration parameters.
configuration = financial_reports_generated_client.Configuration(
    host = "https://api.financialreports.eu"
)

# The client must configure the authentication and authorization parameters
# in accordance with the API server security policy.
# Examples for each auth method are provided below, use the example that
# satisfies your auth use case.

# Configure API key authorization: ApiKeyAuth
configuration.api_key['ApiKeyAuth'] = os.environ["API_KEY"]

# Uncomment below to setup prefix (e.g. Bearer) for API key, if needed
# configuration.api_key_prefix['ApiKeyAuth'] = 'Bearer'


# Enter a context with an instance of the API client
async with financial_reports_generated_client.ApiClient(configuration) as api_client:
    # Create an instance of the API class
    api_instance = financial_reports_generated_client.CompaniesApi(api_client)
    countries = 'countries_example' # str | Filter by Company country ISO Alpha-2 code(s). Comma-separated for multiple values. (optional)
    industry = 'industry_example' # str | Filter by ISIC Group code. (optional)
    industry_group = 'industry_group_example' # str | Filter by ISIC Division code. (optional)
    isin = 'isin_example' # str | Filter by Company ISIN. Case-insensitive. (optional)
    lei = 'lei_example' # str | Filter by Company Legal Entity Identifier (LEI). Case-insensitive. (optional)
    on_watchlist = True # bool | Filter by companies on the user's watchlist. Use 'true' to see only watchlist companies, 'false' to exclude them. Omitting the parameter returns all companies. (optional)
    ordering = 'ordering_example' # str | Which field to use when ordering the results. Available fields: `id`, `name`, `date_ipo`, `year_founded`, `country_iso__name`. Prefix with '-' for descending order (e.g., `-name`). (optional)
    page = 56 # int | A page number within the paginated result set. (optional)
    page_size = 56 # int | Number of results to return per page. (optional)
    search = 'search_example' # str | A search term. (optional)
    sector = 'sector_example' # str | Filter by ISIC Section code. (optional)
    sub_industry = 'sub_industry_example' # str | Filter by ISIC Class code. (optional)
    ticker = 'ticker_example' # str | Filter by Company primary stock Ticker symbol. Case-insensitive. (optional)
    view = summary # str | Controls the level of detail. Omit for a default 'summary' view, or use 'full' to include all details for each company. (optional) (default to summary)

    try:
        # List Companies
        api_response = await api_instance.companies_list(countries=countries, industry=industry, industry_group=industry_group, isin=isin, lei=lei, on_watchlist=on_watchlist, ordering=ordering, page=page, page_size=page_size, search=search, sector=sector, sub_industry=sub_industry, ticker=ticker, view=view)
        print("The response of CompaniesApi->companies_list:\n")
        pprint(api_response)
    except ApiException as e:
        print("Exception when calling CompaniesApi->companies_list: %s\n" % e)

Documentation for API Endpoints

All URIs are relative to https://api.financialreports.eu

Class Method HTTP request Description
CompaniesApi companies_list GET /companies/ List Companies
CompaniesApi companies_retrieve GET /companies/{id}/ Retrieve Company Details
CountriesApi countries_list GET /countries/ List Countries
CountriesApi countries_retrieve GET /countries/{id}/ Retrieve Country
FilingTypesApi filing_types_list GET /filing-types/ List Filing Types
FilingTypesApi filing_types_retrieve GET /filing-types/{id}/ Retrieve Filing Type
FilingsApi filings_list GET /filings/ List Filings
FilingsApi filings_markdown_retrieve GET /filings/{filing_id}/markdown/ Retrieve Filing Markdown
FilingsApi filings_retrieve GET /filings/{id}/ Retrieve Filing Details
ISICClassificationsApi isic_classes_list GET /isic-classes/ List ISIC Classes
ISICClassificationsApi isic_classes_retrieve GET /isic-classes/{id}/ Retrieve ISIC Class
ISICClassificationsApi isic_divisions_list GET /isic-divisions/ List ISIC Divisions
ISICClassificationsApi isic_divisions_retrieve GET /isic-divisions/{id}/ Retrieve ISIC Division
ISICClassificationsApi isic_groups_list GET /isic-groups/ List ISIC Groups
ISICClassificationsApi isic_groups_retrieve GET /isic-groups/{id}/ Retrieve ISIC Group
ISICClassificationsApi isic_sections_list GET /isic-sections/ List ISIC Sections
ISICClassificationsApi isic_sections_retrieve GET /isic-sections/{id}/ Retrieve ISIC Section
LanguagesApi languages_list GET /languages/ List Languages
LanguagesApi languages_retrieve GET /languages/{id}/ Retrieve Language
SourcesApi sources_list GET /sources/ List Data Sources
SourcesApi sources_retrieve GET /sources/{id}/ Retrieve Data Source
WatchlistApi watchlist_companies_create POST /watchlist/companies/ Add Company to Watchlist
WatchlistApi watchlist_companies_destroy DELETE /watchlist/companies/{company_id}/ Remove Company from Watchlist
WatchlistApi watchlist_retrieve GET /watchlist/ Get User's Watchlist
DownloaderApi downloader_jobs_status_retrieve GET /downloader/jobs/{job_id}/status/
SchemaApi schema_retrieve GET /schema/

Documentation For Models

Documentation For Authorization

Authentication schemes defined for the API:

ApiKeyAuth

  • Type: API key
  • API key parameter name: X-API-Key
  • Location: HTTP header

cookieAuth

  • Type: API key
  • API key parameter name: sessionid
  • Location:

Author

api@financialreports.eu

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

financial_reports_generated_client-1.3.3.tar.gz (54.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

File details

Details for the file financial_reports_generated_client-1.3.3.tar.gz.

File metadata

File hashes

Hashes for financial_reports_generated_client-1.3.3.tar.gz
Algorithm Hash digest
SHA256 47dad6e5e5218910214475228641679a55826e53824421f8cbd238f762eb7d3f
MD5 9d9245c7b01639e6f21be9974025753a
BLAKE2b-256 131fcdad1815a5727fdc5a3fca641ebdf28168cfc8a3890bff471b9f6b440869

See more details on using hashes here.

File details

Details for the file financial_reports_generated_client-1.3.3-py3-none-any.whl.

File metadata

File hashes

Hashes for financial_reports_generated_client-1.3.3-py3-none-any.whl
Algorithm Hash digest
SHA256 3002d3473e7f9b49ae564280eb7ff89fd40268ac667a473e598d0d9b58e82107
MD5 a11117d673d067fdf38bf3115614ee00
BLAKE2b-256 8475ac2f849523b1c68eec4997a9e0c7362beef5f9f6d32c382b390ffa379abc

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page