Get France Fundamentals

French fundamentals use the same endpoints as US fundamentals. The only difference is how you name the company: a French ticker together with market=FR, or the company’s ISIN. This guide walks through both.

Prerequisites

Python 3.7+
A Financial Datasets API key (sign up here)
The requests library (pip install requests)

Step 1: Set Up Authentication

import requests

headers = {
    "X-API-KEY": "your_api_key_here"
}

Step 2: Find a French Ticker

Every financials endpoint has a /tickers/ list. Filter it by market=FR to see the French companies we cover, each with its name, ISIN, and whether it is still listed.

url = "https://api.financialdatasets.ai/financials/income-statements/tickers/?market=FR"

response = requests.get(url, headers=headers)
listings = response.json().get("listings")

for listing in listings[:5]:
    print(f"{listing['ticker']}: {listing['name']} ({listing['identifier']}, {listing['status']})")

{
  "resource": "income-statements",
  "listings": [
    {"ticker": "AI", "name": "L'AIR LIQUIDE", "market": "FR", "identifier": "FR0000120073", "identifier_type": "ISIN", "status": "active"},
    {"ticker": "MC", "name": "LVMH MOET HENNESSY-LOUIS VUITTON", "market": "FR", "identifier": "FR0000121014", "identifier_type": "ISIN", "status": "active"}
  ],
  "tickers": ["74SW", "AAA", "AB", "..."]
}

French tickers are the short symbols the Paris market prints, so LVMH is MC and Air Liquide is AI.

Step 3: Fetch Income Statements

Add market=FR next to the ticker. French companies report once a year, so use period=annual.

ticker = "AI"
market = "FR"
period = "annual"
limit = 5

url = (
    f"https://api.financialdatasets.ai/financials/income-statements"
    f"?ticker={ticker}"
    f"&market={market}"
    f"&period={period}"
    f"&limit={limit}"
)

response = requests.get(url, headers=headers)
income_statements = response.json().get("income_statements")

for stmt in income_statements:
    print(f"{stmt['report_period']}: Revenue={stmt['revenue']:,} {stmt['currency']}, Net Income={stmt['net_income']:,} {stmt['currency']}")

Amounts are in the currency the company reports in. Read it from the currency field on each statement: most French companies report in EUR, some in USD (TotalEnergies, for one).

Step 4: Request by ISIN Instead

If you know the ISIN, pass it on its own. No ticker or market is needed.

url = (
    f"https://api.financialdatasets.ai/financials/income-statements"
    f"?isin=FR0000120073"
    f"&period=annual"
    f"&limit=5"
)

response = requests.get(url, headers=headers)
income_statements = response.json().get("income_statements")

Step 5: Fetch Balance Sheets and Cash Flow Statements

The Balance Sheets API and Cash Flow Statements API take the same parameters.

for statement in ["balance-sheets", "cash-flow-statements"]:
    url = (
        f"https://api.financialdatasets.ai/financials/{statement}"
        f"?ticker={ticker}"
        f"&market={market}"
        f"&period={period}"
        f"&limit={limit}"
    )
    response = requests.get(url, headers=headers)
    print(statement, response.json())

To get all three statements in one request, call the All Financial Statements API with the same parameters.

Step 6: Fetch Financial Metrics

The Financial Metrics API returns margins, growth, and per-share values for each annual period, and the Snapshot API the latest period.

url = (
    f"https://api.financialdatasets.ai/financial-metrics"
    f"?ticker={ticker}"
    f"&market={market}"
    f"&period={period}"
    f"&limit={limit}"
)

response = requests.get(url, headers=headers)
financial_metrics = response.json().get("financial_metrics")

for metrics in financial_metrics:
    print(f"{metrics['report_period']}: Gross Margin={metrics['gross_margin']}, Net Margin={metrics['net_margin']}")

Price-based values such as market cap, enterprise value, valuation ratios, and dividend yield are not available for French companies yet and come back as null.

Step 7: Fetch As-Reported Statements

As-reported statements give you the lines exactly as the company printed them in its annual report, with the company’s own labels and subtotals. Add /as-reported to any statement endpoint.

url = (
    f"https://api.financialdatasets.ai/financials/income-statements/as-reported"
    f"?ticker={ticker}"
    f"&market={market}"
    f"&period={period}"
    f"&limit=1"
)

response = requests.get(url, headers=headers)
statement = response.json().get("income_statements")[0]

def print_lines(nodes, depth=0):
    for node in nodes:
        print(f"{'  ' * depth}{node['label']}: {node['value']}")
        print_lines(node["children"], depth + 1)

print_lines(statement["line_items"])

Annual Data Only

French companies file one tagged annual report a year, so period=annual is the only period. A request with period=quarterly or period=ttm returns a 400:

{
  "error": "Invalid period",
  "message": "FR listings carry annual data only. Use period=annual."
}

Next Steps

Market Coverage — which markets are available and how to request each
Income Statements API Reference — full parameter documentation
Financial Metrics API — every metric we calculate
Get US Fundamentals Guide — the same walk-through for US companies
Get UK Fundamentals Guide — the same walk-through for UK companies

Overview

Integrations

Search

Datasets

Guides

Prerequisites

Step 1: Set Up Authentication

Step 2: Find a French Ticker

Step 3: Fetch Income Statements

Step 4: Request by ISIN Instead

Step 5: Fetch Balance Sheets and Cash Flow Statements

Step 6: Fetch Financial Metrics

Step 7: Fetch As-Reported Statements

Annual Data Only

Next Steps

​Prerequisites

​Step 1: Set Up Authentication

​Step 2: Find a French Ticker

​Step 3: Fetch Income Statements

​Step 4: Request by ISIN Instead

​Step 5: Fetch Balance Sheets and Cash Flow Statements

​Step 6: Fetch Financial Metrics

​Step 7: Fetch As-Reported Statements

​Annual Data Only

​Next Steps

Prerequisites

Step 1: Set Up Authentication

Step 2: Find a French Ticker

Step 3: Fetch Income Statements

Step 4: Request by ISIN Instead

Step 5: Fetch Balance Sheets and Cash Flow Statements

Step 6: Fetch Financial Metrics

Step 7: Fetch As-Reported Statements

Annual Data Only

Next Steps