Connect EarthCompliance API
Instruments

Get business involvements

POST/instruments/business-involvements

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.

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/business-involvements" \  -H "x-api-key: $CE_API_KEY" \  -H "Content-Type: application/json" \  -d '{    "holdings": [      {        "isin": "US0378331005"      },      {        "isin": "IE00B4L5Y983"      }    ],    "minimum_threshold": 0  }'
{  "data": [    {      "sustainability_data": {        "total_score": 212,        "environment_score": 71,        "social_score": 68,        "governance_score": 73,        "business_involvements": {          "thermal_coal": {            "weight": 0,            "count": 0          },          "tobacco_distributor": {            "weight": 0,            "count": 0          },          "nuclear_weapons": {            "weight": 0,            "count": 0          }        }      },      "metadata": {        "isin": "US0378331005",        "is_fund": false      }    },    {      "sustainability_data": {        "total_score": 186,        "environment_score": 62,        "social_score": 61,        "governance_score": 64,        "business_involvements": {          "thermal_coal": {            "weight": 0.4,            "count": 3          },          "tobacco_distributor": {            "weight": 0.6,            "count": 5          },          "nuclear_power_generation": {            "weight": 1.2,            "count": 7          }        }      },      "metadata": {        "isin": "IE00B4L5Y983",        "is_fund": true      }    }  ],  "message": "Business involvements of instruments fetched successfully"}

Get SFDR classification POST

Returns the SFDR article (6, 8 or 9) for each ISIN. Needs access to the SFDR framework. Up to 10,000 holdings per request. Entries without an isin are skipped. An empty holdings list fails with 400 and the message Please provide at least one instrument. When no entry has an isin, the response has an empty data list.

Get PAI indicators POST

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.