Parameters
You can query the CTI database using a variety of options. Search directly by company name, or use specific identifiers such as ISIN, LEI, or registration authority ID for precise results. You can also filter by the year of emission to retrieve data for a particular year, or leave this field empty to access data for all available years.
If you have any questions, please contact our support team.
| company_name |
Optional |
The full or partial name of the company to search for. This parameter filters results to match the specified company name. Can be combined with fuzzy_match to allow partial or approximate matching. |
| fuzzy_search |
Optional |
When set to true, enables partial or approximate matching, allowing results that closely resemble the search term but may not be exact. Defaults to false. |
| year_of_emission |
Optional |
The specific year for which you want to retrieve data. Filters results to match records from the selected year. |
| isin |
Optional |
The ISIN (International Securities Identification Number) to search for specific company records. Filters results to match the exact ISIN provided The unique identifier of the registration authority associated with the company. This parameter filters results based on the specific authority that issued the registration. |
| registration_authority_id |
Optional |
The unique ID of the authority where the company is registered. |
| lei |
Optional |
The Legal Entity Identifier (LEI) to search for a specific company or organization. This globally recognized 20-character identifier ensures accurate identification of legal entities. Filters results to match the exact LEI provided. |
Example Response (Success):
{
"status": true,
"data": [
{
"company_name": "SWECO AB (publ)",
"country_code_2_digit_iso": "SE",
"entity_status": "ACTIVE",
"lei": "549300Q4Y55VICYV6U90",
"industry_gics": "Manufacturing",
"industry_group_gics": "Capital Goods",
"sector_gics": "Industrials",
"subindustry_gics": "Building Products",
"revenue": "1500",
"ebitda": "350",
"profit_loss": "100",
"ebit": "200",
"currency": "EUR",
"stock_exchange": "XETRA",
"market_cap_segment": "Large Cap",
"isin": [
"3232jjj123fg3"
],
"mic": "XETR",
"ticker_symbol": "BPG",
"biogenic_outside_scopes": "0",
"scope_1": "150",
"scope_1_2_3_combined_reporting": "700",
"scope_1_2_combined_reporting": "300",
"scope_1_company_facilities": "50",
"scope_1_company_vehicles": "20",
"scope_2_purchased_energy_location_based": "200",
"scope_2_purchased_energy_market_based": "50",
"scope_2_total_unspecified": "300",
"scope_3": "400",
"scope_3_1_purchased_goods_and_services": "100",
"scope_3_10_processing_of_sold_products": "30",
"scope_3_11_use_of_sold_products": "100",
"scope_3_12_end_of_life_treatment_of_sold_products": "0",
"scope_3_13_downstream_leased_assets": "10",
"scope_3_14_franchises": "5",
"scope_3_15_investments": "2",
"scope_3_2_capital_goods": "30",
"scope_3_3_fuel_and_energy_related_activities": "60",
"scope_3_4_upstream_transportation_and_distribution": "80",
"scope_3_5_waste_generated_in_operations": "40",
"scope_3_6_business_travel": "10",
"scope_3_7_employee_commuting": "15",
"scope_3_8_upstream_leased_assets": "0",
"scope_3_9_downstream_transportation_and_distribution": "20",
"num_employees": "250",
"source_1_link": "https://wxgxrkeahybeesfdvqel.supabase.co/storage/v1/object/public/CTI/pdfs/1734810943119-sustainability-SWECO%20AB%20(publ)-1734810943119.pdf",
"source_2_link": "-",
"year_of_emissions": "2022",
"registration_authority_id": "556542-9841",
"financial_report_link": "https://wxgxrkeahybeesfdvqel.supabase.co/storage/v1/object/public/CTI/pdfs/1734810940590-financial-SWECO%20AB%20(publ)-1734810940590.pdf",
"tot_1_2_3": "-",
"kpi_revenue_1_2_t_co2e_t_kr": "-",
"kpi_employee_1_2_t_co2_fte": "-",
"reporting_year": "3",
}
]
}
The data points available in your response depend on your CTI account access level. We offer a wide range of data points, and you’ll receive documentation tailored to your account after subscribing. To learn more, please reach out to us.
Error Scenarios
No API Token
This error occurs when the Authorization token is not provided or is missing in the request header. The server will respond with a ’401 Unauthorized’ status indicating the request is not authenticated.
{
"status" : 401,
"statusText" : "Unauthorized",
"data" : {
"status": false,
"msg": "Missing or invalid Authorization header"
}
}
Company Not found
This error occurs when the company you are searching for does not exist in the database. The server responds with a ’204 Data Not Found’ status and a message explaining that no matching record could be found.
{
"status" : 204,
"statusText" : "Data Not Found",
"data" : {
"status": false,
"msg": "No record found for Arian Bank in the CTI database. Please contact support for further assistance."
}
}
No Company Identifier
This error occurs when no company identifier (e.g., company name, ISIN, or LEI) is provided in the request. The server responds with a ’400 Bad Request’ status indicating that the request is missing required information.
{
"status" : 400,
"statusText" : "Bad Request",
"data" : {
"status": false,
"msg": "Please provide at least one valid company identifier."
}
}
Too Many Requests
This error occurs when too many requests are sent to the server within a short period of time. The server responds with a ’429 Too Many Requests’ status, indicating that the client has exceeded the rate limit.
{
"status" : 429,
"statusText" : "Too Many Requests",
"data" : {
"status": false,
"msg": "Too many requests, please try again after a minute."
}
}
