# Content of API Endpoints (Descriptive) ## **API Endpoints (Updated 10/04/2026)** 2050 Materials provides three core API endpoints, each catering to a different stage of the construction and sustainability workflow — from detailed product lookups, to early-stage benchmarking, to automated matching of real-world procurement data. Here's a simplified explanation of each: ### The 3 API endpoints (read more below) #### 1. Product-Specific Database API This endpoint offers detailed information on more than **180,000 building products** from over **70 countries**, supplied by **3,100+ manufacturers**. It includes a comprehensive range of sustainability metrics for each product, such as Global Warming Potential (GWP), Ozone Depletion Potential (ODP), Acidification Potential (AP), recycled content, water use, and other environmental impact data. This API is useful for professionals seeking specific product-level data to make informed, eco-friendly choices in their projects. It is a complete database covering construction and architectural products, with information gathered from EPDs, certification bodies (Cradle to Cradle, Declare, etc.), and content curated through the 2050 Materials data team. For a preview of the type of information available, please visit [app.2050-materials.com](https://app.2050-materials.com/). **Best for:** detailed product-level carbon and environmental data, material selection, benchmarking "how good is good," and feeding verified data into design and specification tools. *** #### 2. Generic-Materials Database API This endpoint provides average data derived from a wide range of sources, including digitized Environmental Product Declarations (EPDs) and multiple national databases such as **OKOBAUDAT, KBOB, iStructE, ICE, UK Statistics**, and others. It is designed to offer a broader, regionalized perspective on the sustainability metrics of generic construction materials, rather than specific products. This is a frequently updated database of around **12,000 generic construction materials and assemblies** (e.g. wall, floor, or roof build-ups) used in early-stage assessments and as a benchmark against product-specific information. The database is generated by the 2050 Materials data team using state-of-the-art statistical approaches to aggregate and average the ever-growing product library, and is structured according to the 2050 Materials database framework. **Best for:** early-stage design and estimation, regional fall-back values, benchmarking, and any workflow where a specific EPD is not yet available. For a preview of the type of information available, please contact us. *** #### 3. Automated Mapping (Best Match) API This endpoint automates one of the most time-consuming steps in any carbon assessment: connecting unstructured, real-world data — such as a **Bill of Quantities (BoQ), invoice, or cost estimate** — to the right environmental data points inside the 2050 Materials database. Given a list of free-text item descriptions, the Best Match API returns the best-matching generic materials and/or products, along with a match confidence score and the associated carbon and environmental metrics. This removes the need for manual lookup, spreadsheet matching, or custom classification work. This endpoint includes three main components: * **Semantic Matching Engine:** The API uses AI and natural language processing to interpret unstructured item descriptions and align them with the 2050 Materials product and generic-material database. Each match is returned with a confidence score (0–1) so that users can review and validate results. * **Configurable Filtering and Keywords:** Users can narrow results using 20+ product filters (fire performance, EPD operator, product type, company, manufacturing country, etc.) and 15+ generic-material filters (material name, data source, declared unit, date ranges, etc.). Custom keyword dictionaries can also be provided to tailor classifications to a specific project or company taxonomy. * **Structured, Ready-to-Use Response:** For each input item the API returns matched product and material names, classification hierarchies (including Uniclass systems/products/materials), manufacturing emissions data, product URLs, and source identifiers — all in a single structured JSON response ready to be integrated into a reporting pipeline or dashboard. **Best for:** contractors, quantity surveyors, procurement teams, and sustainability analysts who need to turn BoQs, invoices, or procurement data into reliable carbon reports quickly. Typical use cases include automating product categorization from procurement documents, attaching environmental data to bill-of-materials items, and standardizing material classification across datasets and projects. *** Each of these endpoints serves a unique purpose in the realm of sustainable construction, enabling users to access tailored data for specific needs — from detailed product analyses and early-stage benchmarking, to the automated matching of real procurement data against the 2050 Materials database. > **Note:** 2050 Materials also offers an **Embodied Carbon & Warming Potential** endpoint for building-level parametric estimation (based on area, typology, glazing, and similar inputs). This tool remains available on request, but is considered a complementary research-oriented endpoint rather than one of the three core production APIs described above. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.2050-materials.com/data-documentation/content-of-api-endpoints-descriptive.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.