UK Fundamentals in Python

The Financial Datasets API serves annual fundamentals for 674 UK-listed companies, active and delisted, including the FTSE 100: income statements, balance sheets, cash flow statements, financial metrics, and as-reported statements with the lines as the company printed them. The data comes from the tagged annual reports companies file with the UK regulator. Amounts are in the currency the company reports in. Financial metrics carry no price-based values (market cap, valuation ratios) yet. See market coverage for every market. You can call it as a REST endpoint with an API key, or from Claude, ChatGPT, Cursor, and other AI apps through the MCP server, or pay per request with x402. Pricing starts at $20. UK fundamentals use the same endpoints as US fundamentals. The only difference is how you name the company: a UK ticker together with market=UK, 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 UK Ticker

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

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

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": "RR.", "name": "ROLLS-ROYCE HOLDINGS PLC", "market": "UK", "identifier": "GB00B63H8491", "identifier_type": "ISIN", "status": "active"},
    {"ticker": "SHEL", "name": "SHELL PLC", "market": "UK", "identifier": "GB00BP6MXD84", "identifier_type": "ISIN", "status": "active"}
  ],
  "tickers": ["AAL", "ABF", "ADM", "..."]
}

UK tickers keep the spelling their exchange prints, so a ticker like RR. includes the trailing dot.

Step 3: Fetch Income Statements

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

ticker = "RR."
market = "UK"
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']}")

Older code that sends exchange=LSE keeps working: it means market=UK. Amounts are in the currency the company reports in. Read it from the currency field on each statement: most UK companies report in GBP, some in USD or EUR.

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=GB00B63H8491"
    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 UK 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

UK 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": "UK 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
UK fundamentals announcement — what launched and which companies are covered

FAQ

Which UK companies are covered?

Every company that files a tagged annual report with the UK regulator, active and delisted: 674 companies, including the FTSE 100.

Which periods are available?

Annual only. UK companies file one tagged annual report a year, so period=quarterly and period=ttm return a 400.

Can I get the statements as the company printed them?

Yes. The as-reported endpoints return each line in the company’s own order and wording. See As-Reported Financial Statements.

Can an AI agent use this data?

Yes. Claude, ChatGPT, Cursor, and other MCP clients reach it through the Financial Datasets MCP server. An agent with a wallet can also pay per request with x402, with no account.

Overview

Integrations

Search

Datasets

Guides

Prerequisites

Step 1: Set Up Authentication

Step 2: Find a UK 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

FAQ

Which UK companies are covered?

Which periods are available?

Can I get the statements as the company printed them?

Can an AI agent use this data?

​Prerequisites

​Step 1: Set Up Authentication

​Step 2: Find a UK 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

​FAQ

​Which UK companies are covered?

​Which periods are available?

​Can I get the statements as the company printed them?

​Can an AI agent use this data?

Prerequisites

Step 1: Set Up Authentication

Step 2: Find a UK 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

FAQ

Which UK companies are covered?

Which periods are available?

Can I get the statements as the company printed them?

Can an AI agent use this data?