Quickstart
Make your first request in a few minutes.
Get an API key
Ask your Connect Earth contact or customers@connect.earth for a key. Keep it on your server. Never ship it in a browser or mobile app.
Export it in your shell. The samples in these docs read the key from CE_API_KEY.
export CE_API_KEY="your-api-key"Request the SFDR classification of three instruments
curl https://eco.datia.app/instruments/sustainability-profile \
--request POST \
--header "Content-Type: application/json" \
--header "x-api-key: $CE_API_KEY" \
--data '{"holdings":[{"isin":"US0378331005"},{"isin":"IE00B4L5Y983"},{"isin":"DE000BU2Z015"}]}'Read the response
{
"data": [
{
"isin": "US0378331005",
"sustainability_profile": {
"classification": 6,
"description": "Other",
"metadata": null
}
},
{
"isin": "DE000BU2Z015",
"sustainability_profile": {
"classification": null,
"description": null,
"metadata": null
}
},
{
"isin": "IE00B4L5Y983",
"sustainability_profile": {
"classification": 6,
"description": "Other",
"metadata": null
}
}
],
"metadata": {
"message": "Sustainability profile of instruments fetched successfully"
}
}classification is the SFDR article (6, 8 or 9), or null when there is no data for the ISIN. An ISIN without data does not fail the request; it comes back with null values. Funds are listed after the other instruments, so match results on isin rather than on position.
Next steps
- Authentication explains how keys and access work.
- Working with portfolios shows how to store holdings as dated snapshots and manage them.
- The API reference lists every endpoint with its request and response schemas.