Connect EarthCompliance API
Instruments

Get PAI indicators

POST/instruments/sustainability-data

Returns the mandatory SFDR principal adverse impact (PAI) indicators for each ISIN, with their units. Needs access to the SFDR framework. Up to 10,000 holdings per request. Entries without an isin are skipped. An empty holdings list, or one where no entry has an isin, fails with 400 and the message Please provide at least one instrument.

Authorization

apiKey
x-api-key<token>

Your Connect Earth API key.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

curl -X POST "https://eco.datia.app/instruments/sustainability-data" \  -H "x-api-key: $CE_API_KEY" \  -H "Content-Type: application/json" \  -d '{    "holdings": [      {        "isin": "US0378331005"      },      {        "isin": "US5949181045"      }    ]  }'
{  "data": [    {      "sustainability_data": {        "scope_1_emissions": {          "value": 55200,          "unit": "tonnes"        },        "scope_2_emissions": {          "value": 3400,          "unit": "tonnes"        },        "carbon_footprint": {          "value": 1.9,          "unit": "tCO2e/M€"        },        "ghg_intensity_investee_companies": {          "value": 4.3,          "unit": "tCO2e/M€"        }      },      "metadata": {        "isin": "US0378331005",        "is_fund": false      }    },    {      "sustainability_data": {        "scope_1_emissions": {          "value": 144960,          "unit": "tonnes"        },        "scope_2_emissions": {          "value": 393134,          "unit": "tonnes"        },        "carbon_footprint": {          "value": 3.2,          "unit": "tCO2e/M€"        },        "ghg_intensity_investee_companies": {          "value": 17.6,          "unit": "tCO2e/M€"        }      },      "metadata": {        "isin": "US5949181045",        "is_fund": false      }    }  ],  "metadata": {    "message": "Sustainability data of instruments fetched successfully"  }}

Get business involvements POST

Returns ESG scores and business involvements, such as thermal coal or tobacco, for each ISIN. Needs access to the ESG framework. Up to 10,000 holdings per request. Entries without an isin are skipped. An empty holdings list, or one where no entry has an isin, fails with 400 and the message Please provide at least one instrument.

Get ESG data POST

Returns ESG scores and environmental, social and governance metrics for each ISIN, with their units. Needs access to the ESG framework. Up to 10,000 holdings per request. Entries without an isin are skipped. An empty holdings list, or one where no entry has an isin, fails with 400 and the message Please provide at least one instrument.