Download OpenAPI specification:
Datia Open API empowers financial customers to access and consume a wide range of diverse financial services. By leveraging the extensive endpoints available within the Datia ecosystem, users can effortlessly retrieve reports, generate actionable insights, and seamlessly upload portfolios. This facilitates the establishment of a comprehensive and interconnected financial ecosystem, promoting efficient and streamlined financial operations for customers.
Use Datia's ecosystem to generate financial reports enriched with sustainability information, empowering users with comprehensive insights into the intersection of finance and environmental responsibility.
Initiate a sustainability report request, specifying a type. The report will be generated and available for download after the initial request.
required | Array of objects (holdingsRequest) List of holdings the portfolio contains. Supports multiple asset classes(e.g. mutual funds/etfs, equities, fixed-income). |
| name required | string Name of the portfolio |
| snapshot_at | string Date you want the report from (using ISO 8601 format) |
| type required | string Enum: "esg-overview" "mifid2" Type of report from an enum of values |
| benchmark_etf_mutual_fund | any ISIN identifier for the Mutual fund or ETF to benchmark the portfolio with. |
| benchmark_index | string Default: "S&P 500" Enum: "S&P 500" "Nasdaq 100" "DOW 30" "FTSE 100" "OMX 30" "OMX Stockholm" "OMXC 30" "DAX" "CAC 40" "SMI" "AEX" "IBEX 35" "PSI 20" "BEL 20" "ATX 20" "EURO STOXX 50" "Solactive SEK IG Credit Index" Identifier of the index to benchmark against (use |
| methodology_id | number The id of the Sustainable Investments methodology to use in the report (MiFID II Only) |
{- "holdings": [
- {
- "name": "BOND 25% 2026",
- "isin": "XS2081543204",
- "weight": 100,
- "currency": "EUR",
- "market_value": 1000
}
], - "name": "string",
- "snapshot_at": "2022-03-31",
- "type": "esg-overview",
- "benchmark_etf_mutual_fund": null,
- "benchmark_index": "S&P 500",
- "methodology_id": 0
}{- "metadata": {
- "snapshot_at": "2023-03-31",
- "type": "mifid2",
- "default_benchmark": "US78462F1030",
- "identifier": "test-4469bfe2-619c-495b-9e5d-af76eb19f2d3"
}
}Delete a portfolio using an identifier as primary key. In case a portfolio has only one snapshot left it will be deleted as well.
| snapshot_at required | string The snapshot date of the portfolio to be deleted. |
{- "snapshot_at": "string"
}Modify the details of an existing portfolio such as name and currency.
| name | string The new name of the portfolio. Optional, only provide if changing the name. |
| currency | string The new default currency of the portfolio. Optional, only provide if changing the currency. |
{- "name": "string",
- "currency": "string"
}{- "identifier": "string",
- "metadata": { }
}Upload a portfolio into our main platform. This can be used later on to retrieve reports & insights. You can overwrite a portfolio already uploaded using the same identifier.
| snapshot_at required | string Date you want the report from (using ISO 8601 format) |
| name required | string Name of the portfolio |
| identifier | string If you want to identify your fund with an specific id |
| currency | string Default: "USD" Default currency of the fund. 3 digit currency code (ISO 4217) |
required | Array of objects (holdingsRequest) List of holdings the portfolio contains. Can contain (FoF, simple holdings as stock and non-financial instruments as cash). In case you wanna refer to |
{- "snapshot_at": "2022-03-31",
- "name": "string",
- "identifier": "string",
- "currency": "USD",
- "holdings": [
- {
- "name": "BOND 25% 2026",
- "isin": "XS2081543204",
- "weight": 100,
- "market_value": 1000,
- "currency": "EUR"
}
]
}{- "identifier": "string",
- "metadata": { }
}Retrieve for list of instruments their sustainability profile according to SFDR guidance.
required | Array of objects (holdingsSimpleRequest) List of holdings as ISIN codes. |
{- "holdings": [
- {
- "isin": "XS2081543204"
}
]
}{- "data": [
- {
- "isin": "string",
- "sustainability_profile": {
- "classification": 9,
- "description": "Sustainability as an objective",
- "metadata": { }
}
}
], - "metadata": { }
}Retrieve the list of business involvements for a user, including funds and instruments if applicable.
| minimum_threshold | number Default: 0 Minimum threshold for filtering business involvements |
required | Array of objects (holdingsSimpleRequest) List of holdings as ISIN codes. |
{- "minimum_threshold": 0,
- "holdings": [
- {
- "isin": "XS2081543204"
}
]
}{- "data": [
- {
- "metadata": { },
- "sustainability_data": {
- "business_involvements": [
- {
- "count": 0,
- "weight": 0
}
], - "total_score": 0,
- "social_score": 0,
- "environmental_score": 0,
- "governance_score": 0
}
}
]
}Retrieve for list of instruments their sustainability data (PAI indicators) available.
required | Array of objects (holdingsSimpleRequest) List of holdings as ISIN codes. |
{- "holdings": [
- {
- "isin": "XS2081543204"
}
]
}{- "data": [
- {
- "metadata": {
- "is_fund": true,
- "isin": "string"
}, - "sustainability_data": { }
}
]
}Retrieve for list of instruments their ESG data available.
required | Array of objects (holdingsSimpleRequest) List of holdings as ISIN codes. |
{- "holdings": [
- {
- "isin": "XS2081543204"
}
]
}{- "data": [
- {
- "metadata": {
- "is_fund": true,
- "isin": "string"
}, - "sustainability_data": { }
}
]
}Retrieve for a list of instruments their sustainable investment classification according to a provided methodology.
| methodology_id | number Unique methodology identifier (obtained from /sustainable-investments/methodologies) |
required | Array of objects (holdingsSustainableInvestmentsRequest) List of holdings as ISIN codes. |
{- "methodology_id": 230,
- "holdings": [
- {
- "name": "BOND 25% 2026",
- "isin": "XS2081543204",
- "currency": "EUR",
- "market_value": 1000,
- "instrument_type": "bond"
}
]
}{- "data": [
- {
- "isin": "string",
- "name": "string",
- "sustainability_profile": {
- "classification": 9,
- "description": "Sustainable",
- "metadata": { }
}
}
]
}Retrieve for a list of instruments their taxonomy alignment.
required | Array of objects (holdingsSustainableInvestmentsRequest) List of holdings as ISIN codes. |
{- "holdings": [
- {
- "name": "BOND 25% 2026",
- "isin": "XS2081543204",
- "currency": "EUR",
- "market_value": 1000,
- "instrument_type": "bond"
}
]
}{- "data": [
- {
- "taxonomy_alignment_%": 0,
- "taxonomy_alignment_enabling_%": 0,
- "taxonomy_alignment_transitional_%": 0,
- "taxonomy_alignment_no_gas_and_nuclear_turnover_%": 0,
- "taxonomy_alignment_fossil_gas_turnover_%": 0,
- "taxonomy_alignment_fossil_gas_capex_%": 0,
- "taxonomy_alignment_fossil_gas_opex_%": 0,
- "taxonomy_alignment_nuclear_turnover_%": 0,
- "taxonomy_alignment_nuclear_capex_%": 0,
- "taxonomy_alignment_nuclear_opex_%": 0,
- "taxonomy_alignment_no_gas_and_nuclear_turnover_excluding_sovereign_bonds_%": 0,
- "taxonomy_alignment_no_gas_and_nuclear_capex_excluding_sovereign_bonds_%": 0,
- "taxonomy_alignment_no_gas_and_nuclear_opex_excluding_sovereign_bonds_%": 0,
- "taxonomy_alignment_fossil_gas_turnover_excluding_sovereign_bonds_%": 0,
- "taxonomy_alignment_fossil_gas_capex_excluding_sovereign_bonds_%": 0,
- "taxonomy_alignment_fossil_gas_opex_excluding_sovereign_bonds_%": 0,
- "taxonomy_alignment_nuclear_turnover_excluding_sovereign_bonds_%": 0,
- "taxonomy_alignment_nuclear_capex_excluding_sovereign_bonds_%": 0
}
]
}| weight required | number or string Weight of the position in the portfolio, on a scale of 0 to 100. |
| market_value required | number or string Market value of the position expressed in the currency provided in the "currency" field. |
| isin required | string ISIN identifier of the instrument |
| currency required | string 3 digit currency code (ISO 4217) |
| name required | string Name of the instrument |
| instrument_type | string Enum: "stock" "bond" "etf" "mutual-fund" "cash" "option" "future" "forward-contract" "lending" "other" "warrant" "sovereign-bond" Type of instrument |
{- "weight": 0,
- "market_value": 0,
- "isin": "string",
- "currency": "string",
- "name": "string",
- "instrument_type": "stock"
}| isin required | string ISIN identifier of the instrument |
| name required | string Name of the instrument |
| instrument_type required | string Enum: "stock" "bond" "etf" "mutual-fund" "cash" "option" "future" "forward-contract" "lending" "other" "warrant" "sovereign-bond" "index" Type of instrument |
| currency | string 3 digit currency code (ISO 4217) |
| market_value required | number or string Market value of the position expressed in the currency provided in the "currency" field. |
{- "isin": "string",
- "name": "string",
- "instrument_type": "stock",
- "currency": "string",
- "market_value": 0
}