Portfolio Scores API

The Portfolio Scores API endpoint allows you to retrieve aggregated (averaged) climate risk, resilience-adjusted risk, and financial impact metrics across all assets within your institution's portfolios.

You can also restrict the aggregation to specific portfolios using optional query filters.

Endpoint

GET https://app.alphageo.ai/api/public/v1/portfolio

Parameters

Parameters	Required	Type	Description
tier_one_names		string	Comma-separated names of Tier 1 portfolios to include. Example: Fund A,Fund B. If omitted, averages are calculated across all assets in all portfolios.
period		string	Time period. Available values : 2025, 2035, 2050, 2100
scenario		string	Identifier for CMIP6 Emission Scenarios. Available values : SSP245, SSP370, SSP585

Example requests

cURL

$ curl --location 'https://app.alphageo.ai/api/public/v1/portfolio?period=2035&scenario=SSP245' \
--header 'Authorization: dse3X8de878c37b2fd6835c52390303fk15fc3'

Python

import requests

url = "https://app.alphageo.ai/api/public/v1/portfolio?period=2035&scenario=SSP245"

payload = {}
headers = {
  'Authorization': 'dse3X8de878c37b2fd6835c52390303fk15fc3'
}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)

Example response

{
  "identifiers": {
    "SCENARIO": "SSP370",
    "PERIOD": "2035"
  },
  "overall_indicators": {
    "OVERALL_RISK_SCORE_PCT": 62.4,
    "OVERALL_RAJ_SCORE_PCT": 54.1,
    "OVERALL_RISK_SCORE": 31.2,
    "OVERALL_RAJ_SCORE": 22.8
  },
  "heat_stress": {
    "HEAT_SCORE": 75.0,
    "HEAT_RAJ_SCORE": 60.5
  },
  "inland_flooding": {
    "INLAND_SCORE": 18.2,
    "INLAND_RAJ_SCORE": 15.1
  },
  "coastal_flooding": {
    "COASTAL_SCORE": 5.0,
    "COASTAL_RAJ_SCORE": 4.2
  },
  "drought": {
    "DROUGHT_SCORE": 30.0,
    "DROUGHT_RAJ_SCORE": 24.0
  },
  "hurricane_wind": {
    "WIND_SCORE": 45.0,
    "WIND_RAJ_SCORE": 38.0
  },
  "wildfire": {
    "FIRE_SCORE": 10.0,
    "FIRE_RAJ_SCORE": 8.0
  },
  "hail": {
    "HAIL_SCORE": 55.0,
    "HAIL_RAJ_SCORE": 42.0
  },
  "landslide": {
    "LANDSLIDE_SCORE": 2.0,
    "LANDSLIDE_RAJ_SCORE": 1.5
  },
  "earthquake": {
    "EARTHQUAKE_SCORE": 0.0,
    "EARTHQUAKE_RAJ_SCORE": 0.0
  },
  "insurance": {
    "INS_RATE_FIRE": 0.0,
    "INS_RATE_FLOOD": -1.07,
    "INS_RATE_ANNUAL": -1.07
  },
  "utility": {
    "UTIL_RATE_COOLING": 0.38,
    "UTIL_RATE_HEATING": -0.41,
    "UTIL_RATE_ANNUAL": -0.03
  },
  "capex": {
    "CAPEX_FIRE": 0.0,
    "CAPEX_FLOOD": 0.0,
    "CAPEX_CDD": 0.0,
    "CAPEX_ANNUAL": 0.0
  },
  "discount": {
    "10_YEAR_DISCOUNT": 0.09,
    "25_YEAR_DISCOUNT": 0.22,
    "75_YEAR_DISCOUNT": 0.38
  },
  "operation_downtime": {
    "DOWNTIME_DAYS_ANNUAL": 0.08
  },
  "operation_efficiency": {
    "EFFICIENCY_LOSS_ANNUAL": 0.68
  },
  "workforce_productivity": {
    "PRODUCTIVITY_LOSS_ANNUAL": 1.26
  },
  "maintenance_cost": {
    "MAINT_RATE_ANNUAL": -0.04
  },
  "insurability": {
    "UNINSURABLE_COASTAL": 0.0,
    "UNINSURABLE_FIRE": 0.0,
    "UNINSURABLE_INLAND": 0.0,
    "UNINSURABLE_TOTAL": 0.0
  },
  "data_version": "Dec 2025",
  "portfolio_summary": {
    "total_assets": 4320,
    "portfolios_included": [
      "Fund A",
      "Fund B"
    ]
  }
}

Note: The fields from insurance down to insurability will only be present if your institution has access to the Financial Impact Analytics module.