Documentation: ESG Scores & Risk API

Overview

The FinIQ ESG API provides audit-grade sustainability data for over 50,000 global companies. Unlike "Black Box" rating agencies, we expose the raw underlying metrics (Emissions, Board Ratios, Safety Data) alongside our proprietary risk scores, enabling you to build custom materiality models and automate regulatory reporting (SFDR/CSRD).

‍

Key Capabilities:

Coverage: 50,000+ Companies (Public & Private).
Granularity: Raw metrics (e.g. "Total Water Withdrawal") + Aggregate Scores.
Compliance: Mapped to SFDR (EU), TCFD, and SASB standards.
Alpha Signals: Real-time "Controversy Scanning" and Carbon Efficiency factors.

‍

1. Access Methods

Method	Use Case	Format
REST API	Portfolio scoring, risk dashboards.	JSON
Bulk CSV	Compliance reporting (SFDR), factor backtesting.	CSV / Excel
Vector Feed	New: RAG Integration. Audit raw reports.	Embeddings

‍

2. REST API: ESG Endpoint

Endpoint:GET https://api.finiq.data/v1/esg-scores

‍

Request Parameters:

Parameter	Type	Required	Description
api_token	string	Yes	Your API Key.
ticker	string	Yes	Filter by symbol (e.g., TSLA, XOM).
period	year	No	Reporting year (e.g., 2023). Default: Most recent.
include_estimates	boolean	No	Set true to fill missing data with ML-derived estimates (crucial for Scope 3).

‍

Example Request (Python)

import requests

url = "https://api.finiq.data/v1/esg-scores"
params = {
    "api_token": "YOUR_KEY",
    "ticker": "TSLA",
    "period": "2024",
    "include_estimates": "true"
}

response = requests.get(url, params=params)
data = response.json()

‍

Response Structure (JSON)

{
  "ticker": "TSLA",
  "period": "2024",
  "esg_score_aggregate": 68.5,
  "Environment": {
    "scope_1_emissions": 210500,
    "scope_2_emissions": 450000,
    "scope_3_estimated": 12500000,
    "carbon_intensity": 45.2,
    "net_zero_target": 2040
  },
  "Social": {
    "employee_turnover": 0.18,
    "gender_pay_gap": 0.02,
    "lost_time_injury_rate": 1.4
  },
  "Governance": {
    "board_independence": 0.65,
    "dual_class_share": false,
    "controversy_flag": "High (Labor)"
  }
}

‍

3. Data Dictionary (Key Metrics)

Field	Category	Description
carbon_intensity	Environment	Tonnes of CO2e per $1M Revenue. Normalized metric for efficiency comparison across company sizes.
scope_3_estimated	Environment	Estimated supply chain emissions. Often 10x larger than direct emissions. Modeled via sector input-output tables if not reported.
board_independence	Governance	Percentage of board directors who are independent (non-executive). Higher is generally better for shareholder protection.
controversy_flag	Risk	Real-Time Signal. Low, Medium, High. Derived from daily news scanning (e.g., strikes, spills, fraud).

‍

4. Regulatory Mapping (SFDR & TCFD)

Our data is tagged to support direct reporting for major global frameworks.

Framework	Regulation	FinIQ Support
SFDR (EU)	Compliance	Full mapping to PAI (Principal Adverse Impact) indicators (e.g. Gender Pay Gap, Carbon Footprint).
TCFD	Climate Risk	Data for Climate Scenario Analysis (1.5°C vs 2°C pathways).
SASB	Materiality	Sector-specific materiality tags (e.g. "Data Privacy" for Tech, "Water Mgmt" for Mining).

‍

5. Bulk Data Access (CSV)

Download the entire ESG universe for screening and compliance.

File Naming Convention:

‍{Universe}_ESG_Metrics_{Year}.csv

CSV Columns:

Ticker, ISIN, Industry, ESG_Score, E_Score, S_Score, G_Score, Carbon_Intensity, Scope_1, Scope_2, Scope_3, Controversy_Score, PAI_Flags

How to Download:

Navigate to Data Export.
Select ESG & Risk Package.
Choose Universe (e.g. "MSCI World").
Click Download ZIP.

‍

6. Vector Database Feed (RAG-Ready)

Exclusive to FinIQ.
‍Embeds the actual text from Annual Sustainability Reports and Proxy Statements.

Sample Vector Output (Decoded):

"In the 2023 Sustainability Report, Page 45, Tesla commits to removing Cobalt from its cathode supply chain by 2025, citing human rights concerns in the DRC."

Use Case:

"Verify the company's claim about 'Net Zero' targets against their actual CapEx spending."
"Find all companies that mention 'Water Scarcity' as a material risk in their 10-K."

‍

7. Error Handling

400 Bad Request: Invalid Ticker or Year.
401 Unauthorized: Invalid API Key.
429 Too Many Requests: Rate limit exceeded.

‍

8. Need Help?

Developer Support: email dev-support@finiq.data
Slack Community: Join our [Quant Developer Slack]

‍

Author Name

Team Nextmark