sbti-finance-tool 1.1.1__tar.gz

sbti_finance_tool-1.1.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+         
+         Copyright (c) 2025 World Resources Institute; Science Based Targets initiative
+         
+         Permission is hereby granted, free of charge, to any person obtaining a copy
+         of this software and associated documentation files (the "Software"), to deal
+         in the Software without restriction, including without limitation the rights
+         to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+         copies of the Software, and to permit persons to whom the Software is
+         furnished to do so, subject to the following conditions:
+         
+         The above copyright notice and this permission notice shall be included in all
+         copies or substantial portions of the Software.
+         
+         THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+         IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+         FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+         AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+         LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+         OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+         SOFTWARE.

sbti_finance_tool-1.1.1/PKG-INFO

@@ -0,0 +1,129 @@
+Metadata-Version: 2.4
+Name: sbti-finance-tool
+Version: 1.1.1
+Summary: This package helps companies and financial institutions to assess the temperature alignment of current targets, commitments, and investment and lending portfolios, and to use this information to develop targets for official validation by the SBTi.'
+Author: sbti
+Author-email: finance@sciencebasedtargets.org
+Requires-Python: >=3.7.1
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: openpyxl>=2.5.0
+Requires-Dist: pandas>=1.0.0
+Requires-Dist: numpy<2.0.0,>=1.20.0
+Requires-Dist: pydantic>=1.0.0
+Requires-Dist: requests>=2.0.0
+Requires-Dist: six>=1.16.0
+Requires-Dist: xlrd>=2.0.0
+Dynamic: author
+Dynamic: author-email
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: license-file
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+> Visit https://sciencebasedtargets.github.io/SBTi-finance-tool/ for the full documentation
+
+> If you have any additional questions or comments send a mail to: finance@sciencebasedtargets.org
+
+# SBTi Temperature Alignment tool
+
+This package helps companies and financial institutions to assess the temperature alignment of current
+targets, commitments, and investment and lending portfolios, and to use this information to develop
+targets for official validation by the SBTi.
+
+This tool can be used either as a standalone Python package, a REST API or as a simple webapp which provides a simple skin on the API.
+So, the SBTi toolkit caters for three types of usage:
+
+- Users can integrate the Python package in their codebase
+- The tool can be included as a Microservice (containerised REST API) in any IT infrastructure (in the cloud or on premise)
+- As an webapp, exposing the functionality with a simple user interface.
+
+To following diagram provides an overview of the different parts of the toolkit:
+
+    +-------------------------------------------------+
+    |   UI     : Simple user interface on top of API  |
+    |   Install: via dockerhub                        |
+    |            docker.io/sbti/ui:latest             |
+    |                                                 |
+    | +-----------------------------------------+     |
+    | | REST API: Dockerized FastAPI/NGINX      |     |
+    | | Source : github.com/OFBDABV/SBTi_api    |     |
+    | | Install: via source or dockerhub        |     |
+    | |          docker.io/sbti/sbti/api:latest |     |
+    | |                                         |     |
+    | | +---------------------------------+     |     |
+    | | |                                 |     |     |
+    | | |Core   : Python Module           |     |     |
+    | | |Source : github.com/ScienceBasedTargets/     |
+    | | |               SBTi-finance-tool |     |     |
+    | | |Install: via source or PyPi      |     |     |
+    | | |                                 |     |     |
+    | | +---------------------------------+     |     |
+    | +-----------------------------------------+     |
+    +-------------------------------------------------+
+
+As shown above the API is dependent on the Python Repo, in the same way the UI requires the API backend. These dependencies are scripted in the Docker files.
+
+> This repository only contains the Python module. If you'd like to use the REST API, please refer to [this repository](https://github.com/ScienceBasedTargets/SBTi-finance-tool_api) or the same repository on [Dockerhub](https://docker.io/sbti/sbti/api:latest).
+
+## Structure
+
+The folder structure for this project is as follows:
+
+    .
+    ├── .github                 # Github specific files (Github Actions workflows)
+    ├── app                     # FastAPI app files for the API endpoints
+    ├── docs                    # Documentation files (Sphinx)
+    ├── config                  # Config files for the Docker container
+    ├── SBTi                    # The main Python package for the temperature alignment tool
+    └── test                    # Automated unit tests for the SBTi package (Nose2 tests)
+
+## Installation
+
+The SBTi package may be installed using PIP. If you'd like to install it locally use the following command. For testing or production please see the deployment section for further instructions
+
+```bash
+pip install -e .
+```
+
+For installing the latest stable release in PyPi run:
+
+```bash
+pip install sbti
+```
+
+## Development
+
+To set up the local dev environment with all dependencies, [install poetry](https://python-poetry.org/docs/#osx--linux--bashonwindows-install-instructions) and run
+
+```bash
+poetry install
+```
+
+This will create a virtual environment inside the project folder under `.venv`.
+
+### Testing
+
+Each class should be unit tested. The unit tests are written using the Nose2 framework.
+The setup.py script should have already installed Nose2, so now you may run the tests as follows:
+
+```bash
+nose2 -v
+```
+
+### Publish to PyPi
+
+The package should be published to PyPi when any changes to main are merged.
+
+Update package
+
+1. bump version in `pyproject.toml` based on semantic versioning principles
+2. run `poetry build`
+3. run `poetry publish`
+4. check whether package has been successfully uploaded
+
+**Initial Setup**
+
+- Create account on [PyPi](https://pypi.org/)

sbti_finance_tool-1.1.1/README.md

@@ -0,0 +1,113 @@
+> Visit https://sciencebasedtargets.github.io/SBTi-finance-tool/ for the full documentation
+
+> If you have any additional questions or comments send a mail to: financialinstitutions@sciencebasedtargets.org
+
+# SBTi Temperature Alignment tool
+
+This package helps companies and financial institutions to assess the temperature alignment of current
+targets, commitments, and investment and lending portfolios, and to use this information to develop
+targets for official validation by the SBTi.
+
+This tool can be used either as a standalone Python package, a REST API or as a simple webapp which provides a simple skin on the API.
+So, the SBTi toolkit caters for three types of usage:
+
+- Users can integrate the Python package in their codebase
+- The tool can be included as a Microservice (containerised REST API) in any IT infrastructure (in the cloud or on premise)
+- As an webapp, exposing the functionality with a simple user interface.
+
+To following diagram provides an overview of the different parts of the toolkit:
+
+    +-------------------------------------------------+
+    |   UI     : Simple user interface on top of API  |
+    |   Install: via dockerhub                        |
+    |            docker.io/sbti/ui:latest             |
+    |                                                 |
+    | +-----------------------------------------+     |
+    | | REST API: Dockerized FastAPI/NGINX      |     |
+    | | Source : github.com/OFBDABV/SBTi_api    |     |
+    | | Install: via source or dockerhub        |     |
+    | |          docker.io/sbti/sbti/api:latest |     |
+    | |                                         |     |
+    | | +---------------------------------+     |     |
+    | | |                                 |     |     |
+    | | |Core   : Python Module           |     |     |
+    | | |Source : github.com/ScienceBasedTargets/     |
+    | | |               SBTi-finance-tool |     |     |
+    | | |Install: via source or PyPi      |     |     |
+    | | |                                 |     |     |
+    | | +---------------------------------+     |     |
+    | +-----------------------------------------+     |
+    +-------------------------------------------------+
+
+As shown above the API is dependent on the Python Repo, in the same way the UI requires the API backend. These dependencies are scripted in the Docker files.
+
+> This repository only contains the Python module. If you'd like to use the REST API, please refer to [this repository](https://github.com/ScienceBasedTargets/SBTi-finance-tool-api) or the same repository on [Dockerhub](https://docker.io/sbti/sbti/api:latest).
+
+## Structure
+
+The folder structure for this project is as follows:
+
+    .
+    ├── .github                 # Github specific files (Github Actions workflows)
+    ├── app                     # FastAPI app files for the API endpoints
+    ├── docs                    # Documentation files (Sphinx)
+    ├── config                  # Config files for the Docker container
+    ├── SBTi                    # The main Python package for the temperature alignment tool
+    └── test                    # Automated unit tests for the SBTi package (Nose2 tests)
+
+## Installation
+
+The SBTi package may be installed using PIP. If you'd like to install it locally use the following command. For testing or production please see the deployment section for further instructions
+
+```bash
+pip install -e .
+```
+
+For installing the latest stable release in PyPi run:
+
+```bash
+pip install sbti-finance-tool
+```
+
+## Development
+
+To set up the local dev environment with all dependencies, [install poetry](https://python-poetry.org/docs/#osx--linux--bashonwindows-install-instructions) and run
+
+```bash
+poetry install
+```
+
+This will create a virtual environment inside the project folder under `.venv`.
+
+### SBTi Companies Taking Action (CTA) Data
+
+The tool supports multiple formats of the SBTi CTA file:
+- **Per-company format** (default, recommended): One row per company with aggregated target status
+- **Per-target format**: Multiple rows per company with detailed target information
+- **Legacy format**: Original Title Case column format
+
+The tool automatically detects and handles all formats, defaulting to the per-company format for consistency.
+
+### Testing
+
+Each class should be unit tested. The unit tests are written using the Nose2 framework.
+The setup.py script should have already installed Nose2, so now you may run the tests as follows:
+
+```bash
+nose2 -v
+```
+
+### Publish to PyPi
+
+The package should be published to PyPi when any changes to main are merged.
+
+Update package
+
+1. bump version in `pyproject.toml` based on semantic versioning principles
+2. run `poetry build`
+3. run `poetry publish`
+4. check whether package has been successfully uploaded
+
+**Initial Setup**
+
+- Create account on [PyPi](https://pypi.org/)

sbti_finance_tool-1.1.1/SBTi/__init__.py

@@ -0,0 +1,8 @@
+"""
+This package helps companies and financial institutions to assess the temperature alignment of current
+targets, commitments, and investment and lending portfolios, and to use this information to develop
+targets for official validation by the SBTi.
+"""
+from . import data
+from . import utils
+from . import temperature_score

sbti_finance_tool-1.1.1/SBTi/configs.py

@@ -0,0 +1,187 @@
+"""
+This file defines the constants used throughout the different classes. In order to redefine these settings whilst using
+the module, extend the respective config class and pass it to the class as the "constants" parameter.
+"""
+import os
+
+from SBTi.interfaces import ETimeFrames, EScope
+
+
+class ColumnsConfig:
+    # Define a constant for each column used in the
+    COMPANY_ID = "company_id"
+    COMPANY_ISIN = "company_isin"
+    COMPANY_LEI = "company_lei"
+    COMPANY_ISIC = "isic"
+    REGRESSION_PARAM = "param"
+    REGRESSION_INTERCEPT = "intercept"
+    MARKET_CAP = "company_market_cap"
+    INVESTMENT_VALUE = "investment_value"
+    COMPANY_ENTERPRISE_VALUE = "company_enterprise_value"
+    COMPANY_EV_PLUS_CASH = "company_ev_plus_cash"
+    COMPANY_TOTAL_ASSETS = "company_total_assets"
+    TARGET_REFERENCE_NUMBER = "target_type"
+    SCOPE = "scope"
+    SR15 = "sr15"
+    REDUCTION_FROM_BASE_YEAR = "reduction_from_base_year"
+    START_YEAR = "start_year"
+    VARIABLE = "variable"
+    SLOPE = "slope"
+    TIME_FRAME = "time_frame"
+    MODEL = "model"
+    ANNUAL_REDUCTION_RATE = "annual_reduction_rate"
+    EMISSIONS_IN_SCOPE = "emissions_in_scope"
+    TEMPERATURE_SCORE = "temperature_score"
+    COMPANY_NAME = "company_name"
+    OWNED_EMISSIONS = "owned_emissions"
+    COUNTRY = "country"
+    SECTOR = "sector"
+    GHG_SCOPE12 = "ghg_s1s2"
+    GHG_SCOPE3 = "ghg_s3"
+    COMPANY_REVENUE = "company_revenue"
+    CASH_EQUIVALENTS = "company_cash_equivalents"
+    TARGET_CLASSIFICATION = "target_classification"
+    REDUCTION_AMBITION = "reduction_ambition"
+    BASE_YEAR = "base_year"
+    END_YEAR = "end_year"
+    SBTI_VALIDATED = "sbti_validated"
+    ACHIEVED_EMISSIONS = "achieved_reduction"
+    ISIC = "isic"
+    INDUSTRY_LVL1 = "industry_level_1"
+    INDUSTRY_LVL2 = "industry_level_2"
+    INDUSTRY_LVL3 = "industry_level_3"
+    INDUSTRY_LVL4 = "industry_level_4"
+    COVERAGE_S1 = "coverage_s1"
+    COVERAGE_S2 = "coverage_s2"
+    COVERAGE_S3 = "coverage_s3"
+    INTENSITY_METRIC = "intensity_metric"
+    INTENSITY_METRIC_SR15 = "intensity_metric"
+    TARGET_TYPE_SR15 = "target_type"
+    SR15_VARIABLE = "sr15_variable"
+    REGRESSION_MODEL = "Regression_model"
+    BASEYEAR_GHG_S1 = "base_year_ghg_s1"
+    BASEYEAR_GHG_S2 = "base_year_ghg_s2"
+    BASEYEAR_GHG_S3 = "base_year_ghg_s3"
+    REGION = "region"
+    ENGAGEMENT_TARGET = "engagement_target"
+
+    # SR15 mapping columns
+    PARAM = "param"
+    INTERCEPT = "intercept"
+
+    # Output columns
+    WEIGHTED_TEMPERATURE_SCORE = "weighted_temperature_score"
+    CONTRIBUTION_RELATIVE = "contribution_relative"
+    CONTRIBUTION = "contribution"
+
+
+class PortfolioAggregationConfig:
+    COLS = ColumnsConfig
+
+
+class TemperatureScoreConfig(PortfolioAggregationConfig):
+
+    """
+    This factor determines what part of the temperature for a not SBTi-validated company should be the TS and what part
+    should be the default score.
+    The calculated temperature score should not be lower than the current level of
+    global warning which is expressed through the temperature floor constant.
+    """
+
+    SBTI_FACTOR = 1
+    FALLBACK_SCORE: float = 3.2
+    TEMPERATURE_FLOOR: float = 0.0  # Set to 1.3 once the method paper has been updated
+    FILE_SR15_MAPPING = os.path.join(
+        os.path.dirname(os.path.realpath(__file__)), "inputs", "sr15_mapping.xlsx"
+    )
+    FILE_REGRESSION_MODEL_SUMMARY = os.path.join(
+        os.path.dirname(os.path.realpath(__file__)),
+        "inputs",
+        "regression_model_summary.xlsx",
+    )
+
+    DEFAULT_INDUSTRY = "Others"
+
+    VALUE_TARGET_REFERENCE_ABSOLUTE = "absolute"
+    VALUE_TARGET_REFERENCE_INTENSITY = "intensity"
+    VALUE_TARGET_REFERENCE_INTENSITY_BASE = "int"
+
+    SLOPE_MAP = {
+        ETimeFrames.SHORT: "slope5",
+        ETimeFrames.MID: "slope15",
+        ETimeFrames.LONG: "slope30",
+    }
+
+    INTENSITY_MAPPINGS = {
+        ("Revenue", EScope.S1S2): "INT.emKyoto_gdp",
+        ("Revenue", EScope.S3): "INT.emKyoto_gdp",
+        ("Product", EScope.S1S2): "INT.emKyoto_gdp",
+        ("Product", EScope.S3): "INT.emKyoto_gdp",
+        ("Cement", EScope.S1S2): "INT.emKyoto_gdp",
+        ("Cement", EScope.S3): "INT.emKyoto_gdp",
+        ("Oil", EScope.S1S2): "INT.emCO2EI_PE",
+        ("Oil", EScope.S3): "INT.emCO2EI_PE",
+        ("Steel", EScope.S1S2): "INT.emKyoto_gdp",
+        ("Steel", EScope.S3): "INT.emKyoto_gdp",
+        ("Aluminum", EScope.S1S2): "INT.emKyoto_gdp",
+        ("Aluminum", EScope.S3): "INT.emKyoto_gdp",
+        ("Power", EScope.S1S2): "INT.emCO2EI_elecGen",
+        ("Power", EScope.S3): "INT.emCO2EI_elecGen",
+    }
+    ABSOLUTE_MAPPINGS = {
+        ("B06", EScope.S1S2): "Emissions|Kyoto Gases",
+        ("B06", EScope.S3): "Emissions|Kyoto Gases",
+        ("C23", EScope.S1S2): "Emissions|CO2|Energy and Industrial Processes",
+        ("C23", EScope.S3): "Emissions|Kyoto Gases",
+        ("C24", EScope.S1S2): "Emissions|CO2|Energy and Industrial Processes",
+        ("C24", EScope.S3): "Emissions|Kyoto Gases",
+        ("D35", EScope.S1S2): "Emissions|CO2|Energy and Industrial Processes",
+        ("D35", EScope.S3): "Emissions|Kyoto Gases",
+        ("H49", EScope.S1S2): "Emissions|Kyoto Gases",
+        ("H49", EScope.S3): "Emissions|Kyoto Gases",
+        ("H50", EScope.S1S2): "Emissions|Kyoto Gases",
+        ("H50", EScope.S3): "Emissions|Kyoto Gases",
+        ("H51", EScope.S1S2): "Emissions|Kyoto Gases",
+        ("H51", EScope.S3): "Emissions|Kyoto Gases",
+        ("H52", EScope.S1S2): "Emissions|Kyoto Gases",
+        ("H52", EScope.S3): "Emissions|Kyoto Gases",
+        ("H53", EScope.S1S2): "Emissions|Kyoto Gases",
+        ("H53", EScope.S3): "Emissions|Kyoto Gases",
+        ("other", EScope.S1S2): "Emissions|Kyoto Gases",
+        ("other", EScope.S3): "Emissions|Kyoto Gases",
+    }
+
+    TEMPERATURE_RESULTS = "temperature_results"
+    INVESTMENT_VALUE = "investment_value"
+
+
+class PortfolioCoverageTVPConfig(PortfolioAggregationConfig):
+    FILE_TARGETS = os.path.join(
+        os.path.dirname(os.path.realpath(__file__)),
+        "inputs",
+        "current-Companies-Taking-Action.xlsx",
+    )
+    # Temporary URL until the SBTi website is updated
+    CTA_FILE_URL = "https://files.sciencebasedtargets.org/production/files/companies-excel.xlsx"  # Default to per-company
+    CTA_FILE_URL_PER_COMPANY = "https://files.sciencebasedtargets.org/production/files/companies-excel.xlsx"
+    CTA_FILE_URL_PER_TARGET = "https://files.sciencebasedtargets.org/production/files/targets-excel.xlsx"
+    OUTPUT_TARGET_STATUS = "sbti_target_status"
+    OUTPUT_WEIGHTED_TARGET_STATUS = "weighted_sbti_target_status"
+    VALUE_TARGET_NO = "No target"
+    VALUE_TARGET_SET = "Near-term"
+    VALUE_ACTION_COMMITTED = "Commitment"
+    VALUE_ACTION_TARGET = "Target"
+
+    TARGET_SCORE_MAP = {
+        VALUE_TARGET_NO: 0,
+        VALUE_ACTION_COMMITTED: 0,
+        VALUE_TARGET_SET: 100,
+    }
+
+    # SBTi targets overview (TVP coverage)
+    COL_COMPANY_NAME = "Company Name"
+    COL_COMPANY_ISIN = "ISIN"
+    COL_COMPANY_LEI = "LEI"
+    COL_ACTION = "Action"
+    COL_TARGET = "Target"
+    COL_DATE_PUBLISHED = "Date Published"

sbti_finance_tool-1.1.1/SBTi/data/__init__.py

@@ -0,0 +1,14 @@
+"""
+This module contains classes that create connections to data providers.
+"""
+
+from .data_provider import DataProvider
+from .csv import CSVProvider
+from .excel import ExcelProvider
+from .bloomberg import Bloomberg
+from .cdp import CDP
+from .iss import ISS
+from .trucost import Trucost
+from .urgentem import Urgentem
+
+

sbti_finance_tool-1.1.1/SBTi/data/bloomberg.py

@@ -0,0 +1,73 @@
+from typing import Optional, List
+
+import requests
+
+from SBTi.data.data_provider import DataProvider
+from SBTi.interfaces import IDataProviderTarget, IDataProviderCompany
+
+
+class Bloomberg(DataProvider):
+    """
+    Data provider skeleton for Bloomberg.
+    """
+
+    def _request(self, endpoint: str, data: dict) -> Optional[object]:
+        """
+        Request data from the server.
+        Note: This request does in no way reflect the actual implementation, this is only a stub to show what a
+        potential API request COULD look like.
+
+        :param endpoint: The endpoint of the API
+        :param data: The data to send as a body
+        :return: The returned data, None in case of an error.
+        """
+        try:
+            headers = {"Authorization": "Basic: {}:{}".format("username", "password")}
+            r = requests.post(
+                "{}{}".format("host", endpoint), json=data, headers=headers
+            )
+            if r.status_code == 200:
+                return r.json()
+        except Exception as e:
+            return None
+        return None
+
+    def get_targets(self, company_ids: List[str]) -> List[IDataProviderTarget]:
+        """
+        Get all relevant targets for a list of company ids (ISIN). This method should return a list of
+        IDataProviderTarget instances.
+
+        :param company_ids: A list of company IDs (ISINs)
+        :return: A list containing the targets
+        """
+        # TODO: Make an API request
+        # TODO: Transform the result into a dataframe
+        # TODO: Make sure the columns align with those defined in the docstring
+        raise NotImplementedError
+
+    def get_company_data(self, company_ids: List[str]) -> List[IDataProviderCompany]:
+        """
+        Get all relevant data for a list of company ids (ISIN). This method should return a list of IDataProviderCompany
+        instances.
+
+        :param company_ids: A list of company IDs (ISINs)
+        :return: A list containing the company data
+        """
+        # TODO: Make an API request
+        # TODO: Transform the result into a dataframe
+        # TODO: Make sure the columns align with those defined in the docstring
+        raise NotImplementedError
+
+    def get_sbti_targets(self, companies: list) -> list:
+        """
+        For each of the companies, get the status of their target (Target set, Committed or No target) as it's known to
+        the SBTi.
+
+        :param companies: A list of companies. Each company should be a dict with a "company_name" and "company_id"
+                            field.
+        :return: The original list, enriched with a field called "sbti_target_status"
+        """
+        # TODO: Make an API request
+        # TODO: Extract the SBTi target status from the response
+        # TODO: Enrich the original list with this data
+        raise NotImplementedError

sbti_finance_tool-1.1.1/SBTi/data/cdp.py

@@ -0,0 +1,50 @@
+from typing import List
+
+from SBTi.data.data_provider import DataProvider
+from SBTi.interfaces import IDataProviderCompany, IDataProviderTarget
+
+
+class CDP(DataProvider):
+    """
+    Data provider skeleton for CDP.
+    """
+
+    def get_targets(self, company_ids: List[str]) -> List[IDataProviderTarget]:
+        """
+        Get all relevant targets for a list of company ids (ISIN). This method should return a list of
+        IDataProviderTarget instances.
+
+        :param company_ids: A list of company IDs (ISINs)
+        :return: A list containing the targets
+        """
+        # TODO: Make an API request
+        # TODO: Transform the result into a dataframe
+        # TODO: Make sure the columns align with those defined in the docstring
+        raise NotImplementedError
+
+    def get_company_data(self, company_ids: List[str]) -> List[IDataProviderCompany]:
+        """
+        Get all relevant data for a list of company ids (ISIN). This method should return a list of IDataProviderCompany
+        instances.
+
+        :param company_ids: A list of company IDs (ISINs)
+        :return: A list containing the company data
+        """
+        # TODO: Make an API request
+        # TODO: Transform the result into a dataframe
+        # TODO: Make sure the columns align with those defined in the docstring
+        raise NotImplementedError
+
+    def get_sbti_targets(self, companies: list) -> list:
+        """
+        For each of the companies, get the status of their target (Target set, Committed or No target) as it's known to
+        the SBTi.
+
+        :param companies: A list of companies. Each company should be a dict with a "company_name" and "company_id"
+                            field.
+        :return: The original list, enriched with a field called "sbti_target_status"
+        """
+        # TODO: Make an API request
+        # TODO: Extract the SBTi target status from the response
+        # TODO: Enrich the original list with this data
+        raise NotImplementedError