# Clarity AI Developer Hub Documentation > Documentation for Clarity AI Developer Hub ## Guides - [Welcome](https://developer.clarity.ai/docs/developer-and-integration-pages.md) - [API Overview](https://developer.clarity.ai/docs/api-overview.md) - [Getting API Tokens](https://developer.clarity.ai/docs/getting-api-tokens-access-and-authentication.md) - [Using tokens to authenticate](https://developer.clarity.ai/docs/authentication.md) - [Rate limiting](https://developer.clarity.ai/docs/rate-limiting.md) - [Universe API - Async jobs](https://developer.clarity.ai/docs/universe-api-async-jobs.md) - [Create a portfolio](https://developer.clarity.ai/docs/create-a-portfolio.md) - [Request data for a portfolio](https://developer.clarity.ai/docs/request-data-portfolio-level.md) - [Download data for a universe](https://developer.clarity.ai/docs/download-data-for-a-universe.md) - [Mapping between CUSIPs or ISIN and permIds](https://developer.clarity.ai/docs/mapping-isin-to-permids.md) - [EU Taxonomy](https://developer.clarity.ai/docs/eu-taxonomy.md) - [SFDR](https://developer.clarity.ai/docs/sfdr.md) - [Widgets](https://developer.clarity.ai/docs/widgets.md): Learn how to use the Widget Sandbox to demonstrate Clarity AI Widgets and integrate them into your web pages. - [Datafeeds](https://developer.clarity.ai/docs/datafeeds.md) ## API Reference - [/oauth/token](https://developer.clarity.ai/reference/post_oauth-token.md): Get authorization token using client credentials. The authorization token is available only for 60 minutes. After the time has elapsed, a new access token can be generated by entering the key and secret again to generate a new access token. The Token should be used in the header "Authorization" of each request and value "Bearer ". **Optionally** a portfolioId can be provided so the token will only be able to access that portfolio and no other. - [Get portfolio by ID](https://developer.clarity.ai/reference/getportfolio.md): Given a portfolioId, return the portfolio name, status, total and portfolio composition: list of ISINs and portfolio weight. - [Update Portfolio](https://developer.clarity.ai/reference/updateportfolio.md): Update the allocation composition, total and name of a portfolio given its ID. Portfolios can be provided in two ways: 1. By providing percentage weights of each holding (specifying securitiesWeightDistribution as PERCENTAGE). In this case you must also specify a total portfolio value. 2. By providing individual currency amounts for each holding (specifying securitiesWeightDistribution as AMOUNT). In this case, the total portfolio value is not required and you are also able to specify holding-specific currencies. Once created, the unique id of the portfolio will be returned. - [Delete portfolio](https://developer.clarity.ai/reference/deleteportfolio.md): Delete a portfolio given its ID. - [List portfolios](https://developer.clarity.ai/reference/getportfolioslist.md): Paginated list of portfolio names and ids that are available for the user. - [Create Portfolio](https://developer.clarity.ai/reference/createportfolio.md): Create a portfolio with a unique name from a list of holdings using ISIN, CUSIP, LEI or PERMID as the idType for securities. When LEI or PERMID are used, the securityType must also be provided as either EQUITY or FIXED_INCOME. It is also possible to use CASH or OTHER as the idType and provide a custom id (although no scores will be provided for these holdings). Portfolios can be provided in two ways: 1. By providing percentage weights of each holding (specifying securitiesWeightDistribution as PERCENTAGE). In this case you must also specify a total portfolio value. 2. By providing individual currency amounts for each holding (specifying securitiesWeightDistribution as AMOUNT). In this case, the total portfolio value is not required and you are also able to specify holding-specific currencies. Once created, the unique id of the portfolio will be returned. - [Async Job - Get job status](https://developer.clarity.ai/reference/asyncjobstatus.md): This endpoint will return the status of a previously requested async job.
You must have previously obtained a identifier (uuid) for your task using one of the requests to that purpose before you can use this endpoint.

Check this document for a complete explanation of the flow for these Async jobs endpoints - [Async Job - Download compressed result file](https://developer.clarity.ai/reference/asyncdownloadcompressedfile.md): This endpoint will return the file result of your async job request in the form of a compressed .gz file.
You must have previously obtained a identifier (uuid) for your task using one of the requests to that purpose before you can use this endpoint.
Also, it is advisable that you use the Async Job - Get job status endpoint to be sure that your request finished succesfully and your file is ready.

Check this document for a complete explanation of the flow for these Async jobs endpoints - [Async Job - Download result file](https://developer.clarity.ai/reference/asyncdownloadfile.md): This endpoint will return the file result of your async job request.
You must have previously obtained a identifier (uuid) for your task using one of the requests to that purpose before you can use this endpoint.
Also, it is advisable that you use the Async Job - Get job status endpoint to be sure that your request finished succesfully and your file is ready.

Check this document for a complete explanation of the flow for these Async jobs endpoints - [Async Job - Request Securities with the Organization issuer](https://developer.clarity.ai/reference/asyncsecuritiesorganizationsmapping.md):

This endpoint provides the entire universe of Clarity AI securities and provides a mapping of Clarity AI securities between different identifiers.

You can request the mapping by providing a list of PermIds in the permIds parameter or by providing a list of ISINs or CUSIPs in the securityIds parameter, but you CANNOT SPECIFY BOTH permIds and securityIds.

If requesting CUSIPs via securityIds the securityIdsType needs to be set to “CUSIP”.

Leaving securityIds and permIds blank will return the whole Clarity AI universe.

The idColumns allows you to specify a list of security ID types that will be included in the response CSV. Only the securities that have an identifier type matching idColumns will be returned. If you want to retrieve all the securities, you can set idColumns to "ALL" and no securities will be filtered out.
Take into account that when using the "ALL" parameter whenever a new security identifier type is available in the Clarity AI platform it will be included in the CSV response.

The securityTypes parameter allows you to specify which type of securities will be returned: “EQUITY”, “FIXED_INCOME”, or “FUND”. You can specify multiple to receive multiple types or level blank to receive all available securities types.

The additionalOrganizationColumns allows you to specify a list of additional organization columns. At the moment only ORGNAME and ORGCOUNTRY are supported.

The limitResults parameters allows you to limit the number of ISINS returned for each organization.

Please note: This endpoint returns only the identifier (UUID) for the created job. You'll need this UUID value to retrieve the status of your job (see Async Job - Get job status) or to download your file when ready (see Async Job - Download result file). See Async API documentation for a complete explanation of the flow for these async jobs endpoints.

- [Async Job - Request Fund and FundGroupId mapping](https://developer.clarity.ai/reference/asyncfundgroupidmapping.md):

This endpoint provides the entire universe of Clarity AI funds and provides a mapping of Clarity AI Fund Group IDs between different identifiers.

You can request the mapping by providing a list of Fund Group IDs in the fundGroupIds parameter or by providing a list of ISINs or CUSIPs in the fundIds parameter, but you CANNOT SPECIFY BOTH fundGroupIds and fundIds.

If requesting CUSIPs via fundIds the securityIdsType needs to be set to “CUSIP”.

Leaving fundIds and fundGroupIds blank will return the whole Clarity AI universe.

The idColumns allows you to specify a list of security ID types that will be included in the response CSV. Only the funds that have an identifier type matching idColumns will be returned. If you want to retrieve all the securities, you can set idColumns to "ALL" and no funds will be filtered out.
Take into account that when using the "ALL" parameter whenever a new security identifier type is available in the Clarity AI platform it will be included in the CSV response.

The onlyOneSecurityPerFundGroupId parameters allows you to limit the number of ISINs returned to only one for each Found Group ID.

Please note: This endpoint returns only the identifier (UUID) for the created job. You'll need this UUID value to retrieve the status of your job (see Async Job - Get job status) or to download your file when ready (see Async Job - Download result file). See Async API documentation for a complete explanation of the flow for these async jobs endpoints.

- [Async job - Request mapping between Organization PermID and LEI identifiers](https://developer.clarity.ai/reference/asyncorganizationsmapping.md):

This endpoint provides a mapping of Clarity AI organizations between different identifiers.

You can request the mapping by providing a list of PermIDs or LEIs in the ids parameter. You need to specify the type of ids provided in the idType parameter. The idType parameter can be either “PermID” or “LEI”.

Please note: This endpoint returns only the identifier (UUID) for the created job. You'll need this UUID value to retrieve the status of your job (see Async Job - Get job status) or to download your file when ready (see Async Job - Download result file). See Async API documentation for a complete explanation of the flow for these async jobs endpoints.

- [Get top five sectors portfolio carbon footprint](https://developer.clarity.ai/reference/gettopsectorscarbonfootprint.md): Given a portfolio id and a list of metric ids, returns the top five industry sectors with their value for each of the metrics. The supported metrics are: * CONTRIBUTION_TO_TOTAL_FINANCED_EMISSIONS_SCOPE_1_2 Find below the mapping for each of the sector IDs returned in the response: * 10: Energy * 15: Materials * 20: Industrials * 25: Consumer Discretionary * 30: Consumer Staples * 35: Health Care * 40: Financials * 45: Information Technology * 50: Communication Services * 55: Utilities * 60: Real Estate * 90: Governments - [get Portfolio climate scores](https://developer.clarity.ai/reference/getscores.md): Given a portfolio id, returns the Score, Coverage in number of organizations, Coverage in portfolio weight, Reported In number of organizations and Reported In portfolio weight for the main climate metrics: Total CO2 Emissions (Scope 1 + Scope 2), Scope 1 CO2e emissions (Direct), Scope 2 CO2e emissions (Indirect), Scope 3 CO2e emissions (Indirect), 2025 Committed Emissions and Emissions Reduction Commitment 2025. - [Get top ten portfolio climate scores](https://developer.clarity.ai/reference/gettoporganizationscarbonscores.md): Given a portfolio id, returns Organization name, Portfolio weight and scores for climate metrics - [get Portfolio carbon footprint](https://developer.clarity.ai/reference/getfootprint.md): Given a portfolio id, returns Value, Coverage in number of organizations, Coverage in portfolio weight, Reported In number of organizations, Reported In portfolio weight for the main carbon footprint metrics: Portfolio financed emissions and Portfolio Financed Emissions / USD M Invested. - [get Fund Climate scores](https://developer.clarity.ai/reference/getscoressummary.md): Given a Fund identifier it returns analytic estimated total CO2,analytic CO2 intensity 2025, analytic CO2 intensity 2030, Scope1, Scope2, Scope3, reduction CO2 intensity 2025 scoresand its percentiles along with coverage (number of relevant organizations, relevant weight, reported organizations andreported weight. - [get Fund Carbon Footprint](https://developer.clarity.ai/reference/getcarbonfootprintsummary.md): Given a Fund identifier it returns weighted average carbon intensity,fund financed emissions / USD M Invested, fund carbon intensity values and its percentiles along with coverage (number of relevant organizations, relevant weight, reported organizations and reported weight. - [get Fund Climate scores](https://developer.clarity.ai/reference/getscoressummarywithisin.md): Given a Fund ISIN it returns analytic estimated total CO2,analytic CO2 intensity 2025, analytic CO2 intensity 2030, Scope1, Scope2, Scope3, reduction CO2 intensity 2025 scoresand its percentiles along with coverage (number of relevant organizations, relevant weight, reported organizations andreported weight. - [get Fund Carbon Footprint](https://developer.clarity.ai/reference/getcarbonfootprintsummarywithisin.md): Given a Fund ISIN it returns weighted average carbon intensity,fund financed emissions / USD M Invested, fund carbon intensity values and its percentiles along with coverage (number of relevant organizations, relevant weight, reported organizations and reported weight. - [Async Job, get Temperature Alignment raw data for securities](https://developer.clarity.ai/reference/asyncjobtemperaturealignmentsecuritybyid.md): This endpoint will make a request for an async Job to retrieve the whole universe of Clarity.AI Temperature Alignment raw data.
Please note: This call will only return the identifier (uuid) for this task. You'll need this value later on further calls to know the status of your job (see Async Job - Get job status) or download your file when ready (see «Async Job - Download result file»)
Check this document for a complete explanation of the flow for these Async jobs endpoints - [Async Job, get Carbon Footprint Security metric values](https://developer.clarity.ai/reference/asyncjobfootprintsecuritybyid.md): This endpoint will make a request for an async Job to retrieve the whole universe of Clarity.AI Carbon footprint for given metrics ids.
Please note: This call will only return the identifier (uuid) for this task. You'll need this value later on further calls to know the status of your job (see Async Job - Get job status) or download your file when ready (see «Async Job - Download result file»)
Check this document for a complete explanation of the flow for these Async jobs endpoints - [Async Job, get Net Zero organization values](https://developer.clarity.ai/reference/asyncjoborganizationmetricsbypermid.md): This endpoint will make a request for an async Job to retrieve the whole universe at the organization level Net Zero data feed that gives the alignment of each company to Net Zero using an standard Net Zero framework and the underlying metrics used to calculate it.
Please note: This call will only return the identifier (uuid) for this task. You'll need this value later on further calls to know the status of your job (see Async Job - Get job status) or download your file when ready (see «Async Job - Download result file»)
Check this document for a complete explanation of the flow for these Async jobs endpoints - [Async Job, get Temperature Alignment raw data](https://developer.clarity.ai/reference/asyncjobtemperaturealignmentbypermid.md): This endpoint will make a request for an async job to retrieve Clarity.AI Temperature Alignment raw data for given permIds.
You can request the whole values universe or provide a list of permIds (see: permid.org).Please note: This call will only return the identifier (uuid) for this task. You'll need this value later on further calls to know the status of your job (see Async Job - Get job status) or download your file when ready (see «Async Job - Download result file»)
Check this document for a complete explanation of the flow for these Async jobs endpoints - [Async Job, get Carbon Footprint organization metric values](https://developer.clarity.ai/reference/asyncjobcarbonorganizationlevelmetrics.md): This endpoint will make a request for an async job to retrieve Clarity.AI Carbon Footprint organization values for given permIds.
You can request the whole values universe or provide a list of permIds (see: permid.org).Please note: This call will only return the identifier (uuid) for this task. You'll need this value later on further calls to know the status of your job (see Async Job - Get job status) or download your file when ready (see «Async Job - Download result file»)
Check this document for a complete explanation of the flow for these Async jobs endpoints - [Async Job, get Carbon Footprint Historical Emissions raw data](https://developer.clarity.ai/reference/asyncjoborganizationhistoricalemissions.md): This endpoint will make a request for an async Job to retrieve the whole universe of Clarity.AI Carbon footprint Historical Emissions for given metrics ids.
Please note: This call will only return the identifier (uuid) for this task. You'll need this value later on further calls to know the status of your job (see Async Job - Get job status) or download your file when ready (see «Async Job - Download result file»)
Check this document for a complete explanation of the flow for these Async jobs endpoints - [Async Job, get Net Zero organization values for specific requested metrics](https://developer.clarity.ai/reference/asyncjobnzorganizationreceivingmetricsandpermid.md): This endpoint will make a request for an async Job to retrieve the whole universe at the organization level Net Zero data feed that gives the alignment for the Net Zero requested metrics for each company using an standard Net Zero framework and the underlying metrics used to calculate it.
Please note: This call will only return the identifier (uuid) for this task. You'll need this value later on further calls to know the status of your job (see Async Job - Get job status) or download your file when ready (see «Async Job - Download result file»)
Check this document for a complete explanation of the flow for these Async jobs endpoints - [Async Job, get Carbon Footprint fund metric values](https://developer.clarity.ai/reference/asyncjobfootprintbyid.md): This endpoint will make a request for an async Job to retrieve the whole universe of Clarity.AI fund Carbon footprint values for given metrics ids.
Please note: This call will only return the identifier (uuid) for this task. You'll need this value later on further calls to know the status of your job (see Async Job - Get job status) or download your file when ready (see «Async Job - Download result file»)
Check this document for a complete explanation of the flow for these Async jobs endpoints - [Get total score for funds, and also by pillar](https://developer.clarity.ai/reference/getfundwithprofile.md): Returns the Total ESG score, Environmental score, Social score, Governance score and its relevance respectively for a specific Fund, along with esg coverage (% of the fund with esg data), Peer group name of the fund, peer group count (as number of funds in the same peer group), and peer percentile of the fund. - [Get specific scores for a Fund](https://developer.clarity.ai/reference/getfundmetrics.md): Return the requested scores for a given fund (isin). - [Get portfolio top 10 organizations ESG Risk scores by weight](https://developer.clarity.ai/reference/toporganizations_1.md): Given a portfolio id returns the top 10 organizations by portfolio weight and the Total ESG Risk score, Pillars score, its relevance and peers percentile respectively along with ESG Risk Coverage (number of companies and % of the portfolio with ESG Risk data) - [Get Total and pillar scores of the portfolio](https://developer.clarity.ai/reference/esgbyportfolioid.md): Given a portfolio id, returns the Total ESG score, Environmental score, Social score, Governance score and its relevance respectively for a specific Portfolio (portfolioId) calculated using a scoring profile, along with the name of the portfolio, last update date and ESG Coverage (% of the portfolio with esg data). - [Get Specific Scores for Portfolio](https://developer.clarity.ai/reference/getportfoliometrics.md): Return the requested scores for a given portfolioId. - [Async Job - Request ESG Risk Securities Scores](https://developer.clarity.ai/reference/asyncriskgetscores.md): This endpoint will make a request for an async job to retrieve the whole universe of Clarity.AI ESG Risk scores for given security types or security ids, score ids.
You can ask whether to get securities using securityTypes or provide a list of security ids (usually ISINs) with securityIds, but NOT both.Please note: This call will only return the identifier (UUID) for this task. You'll need this value later on further calls to know the status of your job (see Async Job - Get job status) or download your file when ready (see «Async Job - Download result file»)
Check this document for a complete explanation of the flow for these Async jobs endpoints - [Async Job - Request ESG Risk Organizations Scores](https://developer.clarity.ai/reference/asyncriskgetorganizationsscores.md): This endpoint will make a request for an async job to retrieve Clarity.AI ESG Risk scores for given score ids.
You can request the whole scores universe or provide a list of permIds (see: permid.org).Please note: This call will only return the identifier (UUID) for this task. You'll need this value later on further calls to know the status of your job (see Async Job - Get job status) or download your file when ready (see «Async Job - Download result file»)
Check this document for a complete explanation of the flow for these Async jobs endpoints - [Async Job - Request ESG Risk Funds Scores](https://developer.clarity.ai/reference/asyncriskgetfundsscores.md): This endpoint will make a request for an async job to retrieve the whole universe of Clarity.AI ESG Risk Funds scores for given score ids.
Please note: This call will only return the identifier (UUID) for this task. You'll need this value later on further calls to know the status of your job (see Async Job - Get job status) or download your file when ready (see «Async Job - Download result file»)
Check this document for a complete explanation of the flow for these Async jobs endpoints - [Get portfolio values](https://developer.clarity.ai/reference/getportfoliovalues.md): Given a portfolio id, returns mitigation objective values, Coverage in number of organizations, Coverage in portfolio weight, for the requested metrics. - [Get portfolio values by objective and kpi](https://developer.clarity.ai/reference/getportfoliovalues_1.md): Given a portfolio id, an objective and a list of metrics, it returns values for the objective, coverage in number of organizations, coverage in portfolio weight, for the requested metrics. - [Get Fund values by objective](https://developer.clarity.ai/reference/getfundvalues.md): Given a fund ISIN, objective and metrics ids, returns values, coverage in number of organizations, coverage in fund weight, for the requested metrics. - [Get Fund values by objective and kpi](https://developer.clarity.ai/reference/getfundvalues_1.md): Given a fund ISIN, an objective and a list of metrics, it returns values, coverage in number of organizations and coverage in fund weight. - [Get Fund values by kpi for mitigation objective](https://developer.clarity.ai/reference/getfundvaluesall.md): Given a fund ISIN, a list of objectives and kpis, returns values, coverage in number of organizations, coverage in fund weight, for all the metrics. - [Async Job - Request EU Tax Values for Securities](https://developer.clarity.ai/reference/asynceutaxsecuritiesgetvalues.md): This endpoint will make a request to asynchronously retrieve extensive EU Tax information. The asynchronous process will generate a file with EU Tax values for the whole universe of securities or a subset of it if a list of ISINs is included in 'securityIds' parameter. These metrics are dependent on the objective and kpi passed in the request. The metrics required must be added to 'metricIds' attribute. If left empty, all available metrics will be returned. There is also additional information that can be requested using 'optionalColumns' parameter, like NFRD, DISCLOSURE (equities, fixed incomes), METRIC_YEAR, FLAG_SUSTAINABLE_BOND or GROUPED_NUCLEAR_FOSSILGAS aggregated values. It is also possible to include sovereign bonds by setting the parameter 'includeSovereignBonds' to true. Please note: This call will only return the identifier (uuid) for this task. You'll need this value to: - Know the status of your job (see Async Job - Get job status) - Download your file when ready (see Async Job - Download compressed result file) Please refer to Universe API's Technical documentation for a complete explanation of the workflow for these asynchronous job endpoints. - [Async Job - Request Green Investment ratio Values for Securities](https://developer.clarity.ai/reference/asynceutaxsecuritiesgreeninvestmentratiovalues.md): This endpoint makes an asynchronous request to generate a file with EU Taxonomy Green Investment Ratio (GIR) metrics and can be used for reporting under Article 8 of the Taxonomy Regulation. - Use the securityIds parameter to specify a list of ISINs to include in the response. If left empty, the response will include the entire universe of securities. - Use the securityTypes parameter to filter by asset class: FUND, EQUITY, FIXED_INCOME, SUSTAINABLE_BOND, or REST. If left empty, all asset classes will be included. - Use the metricIds parameter to request specific metrics. If left empty, all available metrics will be returned. The metrics applicable to funds have the prefix RATIO and are calculated excluding sovereign bonds. Please note: This call will only return the identifier (uuid) for this task. You'll need this value to: - Know the status of your job (see Async Job - Get job status) - Download your file when ready (see Async Job - Download compressed result file) Please refer to Universe API's Technical documentation for a complete explanation of the workflow for these asynchronous job endpoints. - [Async Job - Request EU Tax Values for Organizations](https://developer.clarity.ai/reference/asynceutaxorganizatonsgetvalues.md): This endpoint will make a request to asynchronously retrieve extensive EU Tax information. The asynchronous process will generate a file with EU Tax values for the whole universe of organizations or a subset of it if a list of Perm Ids is included in 'permIds' parameter. These metrics are dependent on the objective and kpi passed in the request The metrics required must be added to 'metricIds' attribute and if none are requested, the process will return all of them. There is also additional information that can be requested using 'optionalColumns' parameter, like NFRD, DISCLOSURE or METRIC_YEAR Please note: This call will only return the identifier (uuid) for this task. You'll need this value to: - Know the status of your job (see Async Job - Get job status) - Download your file when ready (see Async Job - Download compressed result file) Please refer to Universe API's Technical documentation for a complete explanation of the workflow for these asynchronous job endpoints. - [Async Job - Request Annex XII Values for Organizations](https://developer.clarity.ai/reference/asyncorganizatonsannexxiigetvalues.md): This endpoint will make a request to asynchronously retrieve EU Tax - Annex XII metrics related to nuclear energy and fossil gas activities, at organisation level. The asynchronous process will generate a file with EU Tax - Annex XII values for organizations. - Use the permIds parameter to specify a list of permIds to include in the response. If left empty, the response will include the entire universe of organizations. - Use the metricIds parameter to request specific metrics. If left empty, all available metrics will be returned. Please note: This call will only return the identifier (uuid) for this task. You'll need this value to: - Know the status of your job (see Async Job - Get job status) - Download your file when ready (see Async Job - Download compressed result file) Please refer to Universe API's Technical documentation for a complete explanation of the workflow for these asynchronous job endpoints. - [Async Job - Request EU Tax Values for Funds](https://developer.clarity.ai/reference/asynceutaxfundsgetvalues.md): This endpoint is deprecated. Please use this other endpoint instead to retrieve fund values for the EU taxonomy product. This endpoint will make a request to asynchronously retrieve extensive EU Tax information. The asynchronous process will generate a file with EU Tax values for the whole universe of funds or a subset of it if a list of ISINs is included in 'securityIds' parameter. These metrics are dependent on the objective and kpi passed in the request The metrics required must be added to 'metricIds' attribute and if none are requested, the process will return all of them. There is also the option to include sovereigns bonds in the fund calculation process by setting the parameter 'includeSovereignBonds' to true Please note: This call will only return the identifier (uuid) for this task. You'll need this value to: - Know the status of your job (see Async Job - Get job status) - Download your file when ready (see Async Job - Download compressed result file) Please refer to Universe API's Technical documentation for a complete explanation of the workflow for these asynchronous job endpoints. - [Async Job - Request Annex XII ratio Values for Funds](https://developer.clarity.ai/reference/asyncfundsannexxiigetvalues.md): This endpoint will make a request to asynchronously retrieve EU Tax - Annex XII ratio metrics related to nuclear energy and fossil gas activities, at fund level. The asynchronous process will generate a file with EU Tax - Annex XII ratio values. - Use the securityIds parameter to specify a list ISINs to include in the response. If left empty, the response will include the entire universe of securities. - Use the metricIds parameter to request specific metrics. If left empty, all available metrics will be returned. The information related to funds doesn't include sovereign bonds. Please note: This call will only return the identifier (uuid) for this task. You'll need this value to: - Know the status of your job (see Async Job - Get job status) - Download your file when ready (see Async Job - Download compressed result file) Please refer to Universe API's Technical documentation for a complete explanation of the workflow for these asynchronous job endpoints. - [Get metrics information by organization and objective](https://developer.clarity.ai/reference/getorganizationvalues.md): Given an ISIN, an objective and a list of metrics, it returns the values for all the steps of the metrics requested associated to the objective for the ISIN issuer organization - [Get product level reports for a given portfolio, annex and language](https://developer.clarity.ai/reference/getreport.md): This endpoint will return product level reports attached to the response for the specified portfolio. The report will be provided in .docx format. These reports are pre-contractual and periodic reports for Article 8 or Article 9 funds classified under SFDR (Annex II-V). - [Get the exposures for the requested portfolio](https://developer.clarity.ai/reference/getportfolioexposures.md): Return the exposures of the portfolio to the requested subjects. - [Get specific exposures of the Fund](https://developer.clarity.ai/reference/getfundexposures.md): Return the exposures of the fund to the requested subjects. - [Async Job - Request Securities Exposures](https://developer.clarity.ai/reference/asyncgetsecuritiesexposures.md): This endpoint will make a request for an async job to retrieve the whole universe of Clarity.AI exposures for given security types (or security ids) and exposure ids.
You can ask whether to get securities using securityTypes or provide a list of security ids (usually ISINs) with securityIds, but NOT both.Please note: This call returns only the identifier (UUID) for the created job. You'll need this value later on further calls to know the status of your job (see Async Job - Get job status) or download your file when ready (see «Async Job - Download result file»)
Check this document for a complete explanation of the flow for these async jobs endpoints - [Async Job - Request Organizations Exposures](https://developer.clarity.ai/reference/asyncgetorganizationsexposures.md): This endpoint will make a request for an async job to retrieve Clarity.AI organizations exposures for given exposure ids.
You can request the whole exposures universe (all organizations) or provide a list of organization permIds (see: permid.org).Please note: This call returns only the identifier (UUID) for the created job. You'll need this value later on further calls to know the status of your job (see Async Job - Get job status) or download your file when ready (see «Async Job - Download result file»)
Check this document for a complete explanation of the flow for these async jobs endpoints - [Async Job - Request Organizations Revenue Exposures](https://developer.clarity.ai/reference/asyncgetorganizationsrevenueexposures.md): This endpoint will make a request for an async job to retrieve Clarity.AI organizations revenue exposures for given exposure ids.
You can request the whole exposures universe (all organizations) or provide a list of organization permIds (see: permid.org).Please note: This call returns only the identifier (UUID) for the created job. You'll need this value later on further calls to know the status of your job (see Async Job - Get job status) or download your file when ready (see «Async Job - Download result file»)
Check this document for a complete explanation of the flow for these async jobs endpoints - [Async Job - Request Funds Exposures](https://developer.clarity.ai/reference/asyncgetsecuritiesexposures_1.md): This endpoint will make a request for an async job to retrieve the whole universe of Clarity.AI funds exposures for given exposure ids or security ids.
Please note: This call returns only the identifier (UUID) for the created job. You'll need this value later on further calls to know the status of your job (see Async Job - Get job status) or download your file when ready (see «Async Job - Download result file»)
Check this document for a complete explanation of the flow for these async jobs endpoints - [Async Job - Request securities global norms](https://developer.clarity.ai/reference/asyncsecuritiesgetglobalnorms.md): This endpoint will make a request for an async job to retrieve the whole universe of Clarity.AI with details about breaches / watchlists of the UNGC principles for given security types or security ids
You can ask whether to get securities using securityTypes or provide a list of security ids (usually ISINs) with securityIds, but NOT both.Please note: This call will only return the identifier (UUID) for this task. You'll need this value later on further calls to know the status of your job (see Async Job - Get job status) or download your file when ready (see «Async Job - Download result file»)
Check this document for a complete explanation of the flow for these Async jobs endpoints - [Async Job - Request organizations controversies](https://developer.clarity.ai/reference/asyncorganizationsgetcontroversies.md): This endpoint will make a request for an async job to retrieve a CSV file containing organizations' controversies-related metrics.

The response CSV includes columns for each requested metric. Both permIds and metricIds are optional: if permIds is omitted, all organizations in the universe are returned; if metricIds is omitted, all available metrics are returned.

Please note: This call will only return the identifier (UUID) for this task. You'll need this value later on further calls to know the status of your job (see Async Job - Get job status) or download your file when ready (see «Async Job - Download result file»)
Check this document for a complete explanation of the flow for these Async jobs endpoints - [Get the portfolio impact highlights summary](https://developer.clarity.ai/reference/gethighlightsforportfolio.md): Returns the top level data of the impact highlights of the given portfolio - [Get the Impact highlights summary comparison between two portfolios](https://developer.clarity.ai/reference/gethighlightsforportfolioandportfolio.md): Returns the top level data of the impact highlights for two portfolios, one taken as main portfolio and other as benchmark to compare - [Get the Impact highlights summary comparison between a portfolio and a fund](https://developer.clarity.ai/reference/gethighlightsforportfolioandfund.md): Returns the top level data of the impact highlights of the given portfolio and a fund - [Get the fund and another fund as benchmark impact highlights summary](https://developer.clarity.ai/reference/gethighlightsforfundandfund.md): Returns the impact highlights values for two funds - [Get the fund impact highlights summary](https://developer.clarity.ai/reference/gethighlightsforfund_1.md): Returns the impact highlights values for the given fund - [Get the fund and another fund as benchmark impact highlights summary](https://developer.clarity.ai/reference/gethighlightsforfundandfund_1.md): Returns the impact highlights values for two funds - [Async Job - Request Impact Highlights metric values](https://developer.clarity.ai/reference/ihlsecuritiesgetmetricvalues.md): This endpoint will make a request for an async Job to retrieve the entire universe of Clarity.AI Impact Highlights metric values for given security types and metric Ids.
You can request the securities using securityTypes or provide a list of security ids (usually isins) with securityIds, but NOT both.

Please note the following metrics are not aggregatable due to the nature of their numeric type (percentage): IHL_WOMEN_EMPLOYEES and IHL_EMPLOYMENT_CREATION

This call will only return the identifier (uuid) for this task. You'll need this value later on further calls to know the status of your job (see Async Job - Get job status) or download your file when ready (see «Async Job - Download result file»)
Check this document for a complete explanation of the flow for these Async jobs endpoints - [Async Job - Organizations metric values](https://developer.clarity.ai/reference/ihlorganizationsgetmetricvalues.md): This endpoint will make a request for an async job to retrieve the entire universe of Clarity.AI securities through their ISINs with their respective issuer, identified using the PermId (see: permid.org )If no permIds are set, the entire mapping table will be returned.
Please note the following metrics are not aggregatable due to the nature of their numeric type (percentage): IHL_WOMEN_EMPLOYEES and IHL_EMPLOYMENT_CREATION

This call will only returns the identifier (uuid) for this task. You'll need this value later on further calls to know the status of your job (see Async Job - Get job status) or download your file when ready (see «Async Job - Download result file»)
Check this document for a complete explanation of the flow for these Async jobs endpoints - [Async Job - Request Impact Highlights Funds Metric Values for funds](https://developer.clarity.ai/reference/ihlfundsgetmetricvalues.md): This endpoint will make a request for an async Job to retrieve the entire universe of Clarity.AI Impact Highlights metric values for all funds and given metric Ids.

Please note that the coverage only applies to the applicable universe (e.g. fund with 30% governments and 70% equities, having a coverage of 100% on equities, would have 100% as coverage).

This call will only return the identifier (uuid) for this task. You'll need this value later on further calls to know the status of your job (see Async Job - Get job status) or download your file when ready (see «Async Job - Download result file»)
Check this document for a complete explanation of the flow for these Async jobs endpoints - [Async Job - Request SDG Revenue Alignment Values](https://developer.clarity.ai/reference/sdgrevgetsecuritiesalignments.md): This endpoint will make a request for an async Job to retrieve the entire universe of Clarity.AI SDG Revenue Alignment values for given security types and Alignment Ids.
You can request the securities using securityTypes or provide a list of security ids (usually isins) with securityIds, but NOT both.
Please note: This call will only return the identifier (uuid) for this task. You'll need this value later on further calls to know the status of your job (see Async Job - Get job status) or download your file when ready (see «Async Job - Download result file»)
Check this document for a complete explanation of the flow for these Async jobs endpoints - [Async Job - Request SDG Alignment Values](https://developer.clarity.ai/reference/sdgrevgetsecuritiesalignments_1.md): This endpoint will make a request for an async Job to retrieve the entire universe of Clarity.AI SDG Alignment values for given security types, Alignment Ids and Alignment Types.
You can request the securities using securityTypes or provide a list of security ids (usually isins) with securityIds, but NOT both.
Please note: This call will only return the identifier (uuid) for this task. You'll need this value later on further calls to know the status of your job (see Async Job - Get job status) or download your file when ready (see «Async Job - Download result file»)
Check this document for a complete explanation of the flow for these Async jobs endpoints - [Async Job - Request SDG Revenue Alignments Values for Organizations](https://developer.clarity.ai/reference/sdgrevgetorganizationsalignments.md): This endpoint will make a request for an async job to retrieve the entire universe of Clarity.AI securities through their ISINs with their respective issuer, identified using the PermId (see: permid.org )
If no permIds are set, the entire mapping table will be returned.
Please note: This call will only returns the identifier (uuid) for this task. You'll need this value later on further calls to know the status of your job (see Async Job - Get job status) or download your file when ready (see «Async Job - Download result file»)
Check this document for a complete explanation of the flow for these Async jobs endpoints - [Async Job - Request SDG Alignment Values for Organizations](https://developer.clarity.ai/reference/sdgalignmentgetorganizationsalignments.md): This endpoint will make a request for an async job to retrieve the entire universe of Clarity.AI securities through their ISINs with their respective issuer, identified using the PermId (see: permid.org )
If no permIds are set, the entire mapping table will be returned.
Please note: This call will only returns the identifier (uuid) for this task. You'll need this value later on further calls to know the status of your job (see Async Job - Get job status) or download your file when ready (see «Async Job - Download result file»)
Check this document for a complete explanation of the flow for these Async jobs endpoints - [Async Job - Request SDG Revenue Alignments Values for Funds](https://developer.clarity.ai/reference/sdgrevgetfundsalignments.md): This endpoint will make a request for an async Job to retrieve the entire universe of Clarity.AI SDG Revenue Alignments for all funds and given Alignment Ids.
Please note: This call will only return the identifier (uuid) for this task. You'll need this value later on further calls to know the status of your job (see Async Job - Get job status) or download your file when ready (see «Async Job - Download result file»)
Check this document for a complete explanation of the flow for these Async jobs endpoints - [Async Job - Request SDG Alignments Values for Funds](https://developer.clarity.ai/reference/sdgalignmentgetfundsalignments.md): This endpoint will make a request for an async Job to retrieve the entire universe of Clarity.AI SDG Alignments for all funds and given metric ids.
Please note: This call will only return the identifier (uuid) for this task. You'll need this value later on further calls to know the status of your job (see Async Job - Get job status) or download your file when ready (see «Async Job - Download result file»)
Check this document for a complete explanation of the flow for these Async jobs endpoints - [Get SDG Revenue Alignment Total and Goals Portfolio Scores](https://developer.clarity.ai/reference/portfoliosummary.md): Given a portfolio id, returns the Total and Goals alignments for a specific Portfolio (portfolioId) along alignment composition. - [Get specific SDG Revenue Alignments for Portfolio](https://developer.clarity.ai/reference/portfolioalignments.md): Return the requested alignments for a given portfolioId. - [Get SDG Alignment portfolio summary](https://developer.clarity.ai/reference/portfoliosummaryassessments.md): Given a portfolio id, returns the Total and Goals Alignments for a specific Portfolio (portfolioId) along Total Alignment composition. - [Get SDG Alignment portfolio values](https://developer.clarity.ai/reference/portfolioassessments.md): Return the requested alignments for a given portfolioId. - [Get SDG Revenue Alignment Total and Goals](https://developer.clarity.ai/reference/fundsummarybyisin.md): Given a Fund ISIN, returns the Total and Goals alignments for a specific fund along applicable Coverage. - [Get SDG Revenue Alignment values](https://developer.clarity.ai/reference/fundalignmentsbyisin.md): Given a Fund ISIN, returns the alignments for a specific fund. - [Get SDG Alignment Total and Goals](https://developer.clarity.ai/reference/fundassessmentsummarybyisin.md): Given a Fund ISIN, returns the Total and Goals alignments for a specific fund along applicable Coverage. - [Get SDG Alignment values](https://developer.clarity.ai/reference/fundassessmentsbyisin.md): Given a Fund ISIN, returns the alignments for a specific fund. - [Get portfolio level aggregation per quarter and year aggregation as the average of the 4 quarters.](https://developer.clarity.ai/reference/getquartervalues.md): Given 4 portfolios, each representing the investment on a given quarter, the year to which the quarters correspond to, and a list of metrics; returns the aggregated metric values of per quarter plus the average aggregation metric value, as the yearly value. - [Get SFDR Report for the portfolio](https://developer.clarity.ai/reference/getreport-1.md): Will return the SFDR Report attached to the response for the specified portfolio. The report will be provided in .docx format. - [Get portfolio values](https://developer.clarity.ai/reference/getvalues.md): Given a portfolio id, returns all values for the requested metrics. - [Export portfolio values](https://developer.clarity.ai/reference/getvalues_1.md): Given a portfolio id, returns a csv file containing all values for the requested metrics. - [Async Job - Request SFDR Raw Metric Values for Securities](https://developer.clarity.ai/reference/asyncsfdrsecuritiesgetrawvalues.md): This endpoint will make a request to asynchronously retrieve extensive SFDR information. The asynchronous process will generate a file with SFDR raw values for the whole universe of securities. Please note: This call will only return the identifier (uuid) for this task. You'll need this value to: - Know the status of your job (see Async Job - Get job status) - Download your file when ready (see Async Job - Download compressed result file) Please refer to Universe API's Technical documentation for a complete explanation of the workflow for these asynchronous job endpoints. - [Async Job - Request SFDR Values for Securities](https://developer.clarity.ai/reference/asyncsfdrsecuritiesgetvalues.md): This endpoint will make a request to asynchronously retrieve extensive SFDR information. The asynchronous process will generate a file with SFDR values for the whole universe of securities. Please note: This call will only return the identifier (uuid) for this task. You'll need this value to: - Know the status of your job (see Async Job - Get job status) - Download your file when ready (see Async Job - Download compressed result file) Please refer to Universe API's Technical documentation for a complete explanation of the workflow for these asynchronous job endpoints. - [Async Job - Request SFDR Raw Metric Values for Organizations](https://developer.clarity.ai/reference/asyncsfdrorganizationsgetrawvalues.md): This endpoint will make a request to asynchronously retrieve extensive SFDR information. The asynchronous process will generate a file with SFDR raw values for the whole universe of organizations. Please note: This call will only return the identifier (uuid) for this task. You'll need this value to: - Know the status of your job (see Async Job - Get job status) - Download your file when ready (see Async Job - Download compressed result file) Please refer to Universe API's Technical documentation for a complete explanation of the workflow for these asynchronous job endpoints. - [Async Job - Request SFDR Values for Organizations](https://developer.clarity.ai/reference/asyncsfdrorganizationsgetvalues.md): This endpoint will make a request to asynchronously retrieve extensive SFDR information. The asynchronous process will generate a file with SFDR values for the whole universe of organizations. Please note: This call will only return the identifier (uuid) for this task. You'll need this value to: - Know the status of your job (see Async Job - Get job status) - Download your file when ready (see Async Job - Download compressed result file) Please refer to Universe API's Technical documentation for a complete explanation of the workflow for these asynchronous job endpoints. - [Async Job - Request SFDR Values for Funds](https://developer.clarity.ai/reference/asyncsfdrfundsgetvalues.md): This endpoint will make a request to asynchronously retrieve extensive SFDR information. The asynchronous process will generate a file with SFDR values for the whole universe of funds. Please note: This call will only return the identifier (uuid) for this task. You'll need this value to: - Know the status of your job (see Async Job - Get job status) - Download your file when ready (see Async Job - Download compressed result file) Please refer to Universe API's Technical documentation for a complete explanation of the workflow for these asynchronous job endpoints. - [get Portfolio tcfd scores](https://developer.clarity.ai/reference/getportfoliovalues-1.md): Given a portfolio id and metric id, returns the Score, Coverage in number of organizations, Coverage in portfolio weight, unit - [Async Job, get Climate Scenario Analysis Security metric values](https://developer.clarity.ai/reference/asyncjobscenarioanalysissecurities.md): This endpoint will make a request for an async Job to retrieve the whole universe of Clarity.AI Climate Scenario Analysis for given metrics ids
Please note: This call will only return the identifier (uuid) for this task. You'll need this value later on further calls to know the status of your job (see Async Job - Get job status) or download your file when ready (see «Async Job - Download result file»)
Check this document for a complete explanation of the flow for these Async jobs endpoints - [MiFID II Full Data - Async Job](https://developer.clarity.ai/reference/fullmifid.md): This endpoint will make a request to asynchronously retrieve extensive MiFID II information. The asynchronous process will generate a file with full MiFID II information for the whole universe of securities. Please note: This call will only return the identifier (uuid) for this task. You'll need this value to: - Know the status of your job (see Async Job - Get job status) - Download your file when ready (see Async Job - Download compressed result file) Please refer to Universe API's Technical documentation for a complete explanation of the workflow for these asynchronous job endpoints. - [MiFID II Classifier Data - Async Job](https://developer.clarity.ai/reference/classifiermifid.md): This endpoint will make an asynchronous request to retrieve simplified MiFID II information. The asynchronous process will generate a file containing simplified MiFID II information for the entire universe of securities. Please note: This call will only return the identifier (uuid) for this task. You'll need this value to: - Know the status of your job (see Async Job - Get job status) - Download your file when ready (see Async Job - Download compressed result file) Please refer to Universe API's Technical documentation for a complete explanation of the workflow for these asynchronous job endpoints. - [Async Job - Request Sustainable Investment values for securities](https://developer.clarity.ai/reference/asyncsustainableinvestmentsecuritiesgetvalues.md): This endpoint will make a request to asynchronously retrieve extensive Sustainable Investment information. The asynchronous process will generate a file with Sustainable Investment values for the whole universe of securities. Please note: This call will only return the identifier (uuid) for this task. You'll need this value to: - Know the status of your job (see Async Job - Get job status) - Download your file when ready (see Async Job - Download compressed result file) Please refer to Universe API's Technical documentation for a complete explanation of the workflow for these asynchronous job endpoints. - [Async Job - Request Sustainable Investment values for organizations](https://developer.clarity.ai/reference/asyncsustainableinvestmentorganizationsgetvalues.md): This endpoint will make a request to asynchronously retrieve extensive Sustainable Investment information. The asynchronous process will generate a file with Sustainable Investment values for the whole universe of organizations. Please note: This call will only return the identifier (uuid) for this task. You'll need this value to: - Know the status of your job (see Async Job - Get job status) - Download your file when ready (see Async Job - Download compressed result file) Please refer to Universe API's Technical documentation for a complete explanation of the workflow for these asynchronous job endpoints. - [Get Portfolio Values By Securities and Totals](https://developer.clarity.ai/reference/siportfoliosecuritiesvaluesandtotalcustom.md): Given a portfolio id, returns portfolio name, total SI's values for the portfolio, and SI values for each security in the portfolio. It is possible to customize SI methodology using profile. - [Get Portfolio Values By Organizations and Totals](https://developer.clarity.ai/reference/siportfolioorganizationsvaluesandtotalcustom.md): Given a portfolio id, returns portfolio name, total SI's values for the portfolio, and SI values for each organization in the portfolio. It is possible to customize SI methodology using profile - [Async Job - Request Nature Biodiversity Impact Values for Securities](https://developer.clarity.ai/reference/asyncjobsecuritiesbyimpactid.md): This endpoint will make a request for an async Job to retrieve the entire universe of Clarity.AI Nature Biodiversity Impact values for given security types.
You can request the securities using securityTypes or provide a list of security ids (usually isins) with securityIds, but NOT both.
Please note: This call will only return the identifier (uuid) for this task. You'll need this value later on further calls to know the status of your job (see Async Job - Get job status) or download your file when ready (see «Async Job - Download result file»)
Check this document for a complete explanation of the flow for these Async jobs endpoints - [Async Job - Request Nature Biodiversity TNFD Values for Organizations](https://developer.clarity.ai/reference/asyncjoborganizationsbytnfdid.md): This endpoint will make a request for an async job to retrieve the entire universe of Clarity.AI securities through their ISINs with their respective issuer, identified using the PermId (see: permid.org )
If no permIds are set, the entire mapping table will be returned.
Please note: This call will only returns the identifier (uuid) for this task. You'll need this value later on further calls to know the status of your job (see Async Job - Get job status) or download your file when ready (see «Async Job - Download result file»)
Check this document for a complete explanation of the flow for these Async jobs endpoints - [Async Job - Request Nature Biodiversity Impact Values for Organizations](https://developer.clarity.ai/reference/asyncjoborganizationsbyimpactid.md): This endpoint will make a request for an async job to retrieve the entire universe of Clarity.AI securities through their ISINs with their respective issuer, identified using the PermId (see: permid.org )
If no permIds are set, the entire mapping table will be returned.
Please note: This call will only returns the identifier (uuid) for this task. You'll need this value later on further calls to know the status of your job (see Async Job - Get job status) or download your file when ready (see «Async Job - Download result file»)
Check this document for a complete explanation of the flow for these Async jobs endpoints - [Async Job - Request Nature Biodiversity Dependencies Values for Organizations](https://developer.clarity.ai/reference/asyncjoborganizationsbydependenciesid.md): This endpoint will make a request for an async job to retrieve the entire universe of Clarity.AI securities through their ISINs with their respective issuer, identified using the PermId (see: permid.org )
If no permIds are set, the entire mapping table will be returned.
Please note: This call will only returns the identifier (uuid) for this task. You'll need this value later on further calls to know the status of your job (see Async Job - Get job status) or download your file when ready (see «Async Job - Download result file»)
Check this document for a complete explanation of the flow for these Async jobs endpoints - [Async Job - Request Nature Biodiversity Impact Values for Funds](https://developer.clarity.ai/reference/asyncjobfundsbyimpactid.md): This endpoint will make a request for an async Job to retrieve the entire universe of Clarity.AI values for all funds.
Please note: This call will only return the identifier (uuid) for this task. You'll need this value later on further calls to know the status of your job (see Async Job - Get job status) or download your file when ready (see «Async Job - Download result file»)
Check this document for a complete explanation of the flow for these Async jobs endpoints - [Redirect to widget with Base64 encoded parameters](https://developer.clarity.ai/reference/redirecttowidget.md): Redirects to a widget URL using Base64 encoded JSON containing token, ISIN, and language (equity only AND certain companies covered by the reports). ## JSON Structure The Base64 encoded JSON should contain: ```json { "token": "jwt_token", "isin": "ISIN_CODE", "lang": "en-US", "modules": ["ESG_RISK", "CONTROVERSIES"] } ``` ## Authentication Token **How to get JWT token:** - **API Login**: POST `/oauth/token` with API key/secret credentials - The token is returned in the response under the `token` field - Include the token in the `Authorization: Bearer ` header for authenticated requests ## Valid ISINs (equity only and certain companies covered by the reports) **Requirements:** - **Equity securities only** - Only equity instruments (EQUITY type) are supported - **Company coverage** - The company must be covered by our ESG Risk assessment reports **Coverage Requirements:** - The ISIN must be mapped to a valid organization ID in our system - The company must be covered by our ESG Risk assessment - Non-equity securities and uncovered companies will return 404 errors ## Language Support **Supported Language Codes:** - `en` - English (generic) - `en-US` - English (United States) - `de` - German (generic) - `de-DE` - German (Germany) - `de-CH` - German (Switzerland) - `es` - Spanish (generic) - `es-ES` - Spanish (Spain) - `fr` - French (generic) - `fr-FR` - French (France) - `fr-CH` - French (Switzerland) ## Modules Support **Available Module Types:** - `ESG_RISK` - ESG Risk assessment module - `CONTROVERSIES` - Controversies and incidents module - `CLIMATE` - Climate and carbon footprint module **Module Array Requirements:** - Optional parameter - can be omitted entirely - If provided, must be an array of strings - Empty arrays or arrays with only empty strings are treated as no modules specified - Order of modules is preserved in the final request - [Download Company AI Report PDF by ISIN](https://developer.clarity.ai/reference/downloadcompanybriefbyisin.md): Returns a PDF file for the specified ISIN (equity only AND certain companies covered by the reports). - [Async Job - Request PAB Values for Securities](https://developer.clarity.ai/reference/asyncesmasecuritiesgetvalues.md): The ESMA Securities ASYNC API will return a unique identifier for the task (uuid), which can then be used to call the Job ASYNC APIs to download a CSV response file. This API provides metrics for securities compliance or non-compliance with the Paris Aligned Benchmark (PAB), including detailed metrics for each PAB criterion. You can specify the metrics you want using the MetricIds parameter. You can request securities using securityTypes (FIXED_INCOME, EQUITY) or provide a list of securityIds (ISINs or CUSIPs) with securityIdsType, but NOT both in the same request. Check this document for a complete explanation of the flow for these Async jobs endpoints. - [SCS portfolio report](https://developer.clarity.ai/reference/swissclimatescore.md) ## Changelog - [SFDR - different endpoints affected by M10 Assessment Selector](https://developer.clarity.ai/changelog/sfdr-different-endpoints-affected-by-m10-assessment-selector.md) - [Nuclear and Gas fields in EU Taxonomy Portfolio API](https://developer.clarity.ai/changelog/nuclear-and-gas-fields-in-eu-taxonomy-portfolio-api.md) - [ESMA - New PAB endpoint for securities](https://developer.clarity.ai/changelog/esma-new-pab-endpoint-for-securities.md) - [SFDR Sustainable investment addition of DNSH percentile customization](https://developer.clarity.ai/changelog/sfdr-sustainable-investment-addition-of-dnsh-percentile-customization.md) - [Exposures - Organizations (exposed revenue)](https://developer.clarity.ai/changelog/exposures-organizations-exposed-revenue.md)