# Version Log

**Version 1.0.37 - 22nd April 2026**

* Introduced `functional_unit` on get\_products API to convert the data into a pre-specifed unit.&#x20;

**Version 1.0.36 - 11th April 2026**

* Renamed the `"material_types"` response key to `"material_type"` (singular) in the `get_product_filters` endpoint, consistent with the `material_type` parameter used by `get_products`. The request parameter `?filters=material_types` continues to work as a backward-compatible alias.
* Updated the `"filter_type"` values for certification filters in `get_product_filters` from `"certification_types"` / `"certification_types_family"` to `"certificate_type"` / `"certificate_type_family"`, aligning with the query parameters accepted by `get_products`. The old request parameters `?certification_types=` and `?certification_types_family=` continue to work as backward-compatible aliases.

**Version 1.0.35 - 30th March 2026**

* Updated the Boverkets generic materials database to V02.07.000

**Version 1.0.34 - 27th March 2026**

* Added `__min` / `__max` range filtering support to `get_products` and `get_generic_materials` endpoints, enabling numerical field filtering across LCA, physical, technical, circularity, HVAC, carbon, environmental, and grey energy fields

**Version 1.0.33 - 18th March 2026**

* Expanded the generic materials database by including an MEP Machinery database calculated by the 2050 Materials Research team.
* Expanded the fields of the `get_products` API to include  `standardised_name` , a better way to search for products by technical parameters.&#x20;
* Expanded the data points under the generic data source `2050 Materials Research (Structural Materials)` to include Structural Steel with (20%, 40%, 60%, 80% Recycled Content)

**Version 1.0.32 - 5th December 2025**

* Expanded the generic materials database by including the newest [Boverkets](https://www.boverket.se/sv/PBL-kunskapsbanken/regler-om-byggande/boverkets-byggregler/) (Swedish Generic Database).

**Version 1.0.31 - 1st December 2025**

* Included a new API filter on /get\_products to exclude products without a specific field (e.g. `exclude_nulls=manufacturing`&#x20;

**Version 1.0.30 - 18th November 2025**

* Expanded the generic materials database by including the newest [ICE Database (V4.1)](/data-documentation/data-sources.md) by Circular Ecology&#x20;

**Version 1.0.30 - 16th November 2025**

* Updated the `unique_product_uuid_v2` filter behaviour on `get_products` to allow multiple uuids, comma-separated.

**Version 1.0.29 - 12th November 2025**

* Updated the `certificate_url` field behavior for product APIs and CSVs. For security reasons, links will now trigger an automatic PDF download instead of displaying the file in the browser.

**Version 1.0.28 - 4th September 2025**

* Added functionality to sort get\_products results by proximity to a lat/long or a location (see more [here](/readme/using-the-2050-materials-api/available-endpoints/product-data-full.md#filtering-the-data))
* Included "city" under `get_product_filters` and enabled filtering by the same field on `get_products`&#x20;
  * Included a mapping dictionary to indicate cities under a country under  `get_product_filters` `Example: 'country_city_map': {'Algeria': [{'id': 1541, 'value': 'Bethioua'},...`

**Version 1.0.27 - 28th August 2025**

* Expanded the Generic Data by including the [New Zealand Environment Ministry GHG Database (2025)](https://environment.govt.nz/publications/measuring-emissions-guide-2025/)

**Version 1.0.26 - 14th August 2025**

* Added our new sdk ([sdk.2050-materials.com](https://sdk.2050-materials.com)) to the documentation

**Version 1.0.25 - 11th August 2025**

* Updated the Data Sources table under [Generic Material Data](/readme/using-the-2050-materials-api/available-endpoints/generic-material-data.md) to reflect the upload of the 2022 UK GHG Factors database.

**Version 1.0.24 - 3rd August 2025**

* Updated the output fields under the [Generic Material Data](/readme/using-the-2050-materials-api/available-endpoints/generic-material-data.md) endpoint to reflect new fields:
  * `linear_density`, `mass_per_piece`, `cross_sectional_area`, `mass_per_declared_unit`

**Version 1.0.23 - 8th July 2025**

* Uploaded the new UK GHG Conversion Factors 2025 ([source](https://www.gov.uk/government/publications/greenhouse-gas-reporting-conversion-factors-2025)) under the [Generic Material Data](/readme/using-the-2050-materials-api/available-endpoints/generic-material-data.md) endpoint.

**Version 1.0.22 - 26th June 2025**

* Updated data sources for generic materials endpoint to reflect the new MEP database generated by the 2050 Materials research team.&#x20;
* Improvements to the speed of `get_product_filters` endpoint
* Introduced a new field under `get_products` called `certificates` with information on all available certificates on products (e.g. FSC, Datasheets, etc.). More information [here](/readme/using-the-2050-materials-api/available-endpoints/product-data-full.md#product-fields-1).

**Version 1.0.21 - 16th June 2025**

* `get_product_filters` and `get_generic_material_filters` now take filtering, to render dynamic dropdowns of the available fields within a response.

**Version 1.0.20 - 7th May 2025**

* Added a new data source of generic material factors: `EPA GHG Emission Factors Hub`&#x20;
* Updated the Swiss KBOB database to Version 6.2

**Version 1.0.19 - 30th April 2025**

* Added multiple filters on `get_products` and `get_generic_materials`  endpoints

**Version 1.0.18 - 18th April 2025**

* Note on documentation regarding name filtering when including special characters like `+` or `&`

**Version 1.0.17 - 1st April 2025**

* Introduced the updated 2025 Timber Development dataset ([link](https://timberdevelopment.uk/resources/2025-embodied-carbon-data-for-timber-products/)) into the generic materials endpoint.

**Version 1.0.16 - 25th March 2025**

* Introduced the New Zealand GHG Database under the get\_generic\_materials endpoint

**Version 1.0.15 - 17th March 2025**

* Introduced `epd_operator` field and filter on `get_products`
* Introduced `epd_operator` field on `get_best_match`

**Version 1.0.14 - 21st February 2025**

* Introduced the CLF MEP data per m2 based on [the following study](https://carbonleadershipforum.org/office-buildings-lca/)

**Version 1.0.13 - 17th February 2025**

* Introduced data=mini filter on `get_products` and `get_generic_materials`

**Version 1.0.12 - 11th February 2025**

* Expanded the generic materials database by including the Payette's Kaleidoscope assembly data (GWP Fossil for stages A1-A4).&#x20;

**Version 1.0.11 - 4th November 2024**

* Expanded the generic materials database by including the Australian National Greenhouse Accounts Factors (July 2023).&#x20;

**Version 1.0.10 - 29 October 2024**

* `get_generic_materials` endpoint now includes all the decimal points on carbon figures.

**Version 1.0.9 - 25 September 2024**

* Expanded datasets under the `get_generic_materials` endpoint to include the 2050 Materials Structural Materials Dataset, which contains more detailed data for structural concrete mixes and timber.

**Version 1.0.8 - 11 September 2024**

* Expanded datasets under the `get_generic_materials` endpoint to include the 2050 Materials Quantity Surveyor Dataset - 2024 Materials Database, which is used in the integration into [CostX](https://finance.yahoo.com/news/rib-software-partners-2050-materials-134218344.html?guccounter=1), and the 2024 Future Homes Materials Database

**Version 1.0.7 - 10 September 2024**

* Expanded datasets under the `get_generic_materials` endpoint to include the 2024 UK National Statistics GHG factors and the New Zealand Environment Ministry - GHG Factors.
* Speed improvements to the API
* Minor bug fixes

**Version 1.0.6 - 7 August 2024**

* Speed improvements for all endpoints
* Expanded product types and material types for all data
* Introduced `get_generic_material_filters` endpoint
* Data sources expanded for `get_generic_materials` endpoint (Essex Policy)

**Version 1.0.5 - 17 June 2024**

* Bug fixes on `get_product` endpoint
* Data sources expanded for `get_generic_materials` endpoint

**Version 1.0.4 - 27 May 2024**

* Introduced expiration filters for `get_products` endpoint
* Logged methodology documentation for the embodied carbon benchmark tool

**Version 1.0.3 - 20 May 2024**

* Introduced `sort_by=material_name` to render results alphabetically
* Extended `sort_by` to source\_uuid, product\_type, material\_type, data\_source, and material\_type for `get_generic_materials` and `get_products`

**Version 1.0.2 - 29 April 2024**

* Added filters `data_source`, `updated_after`, `updated_before`, `created_after`, `created_before`, `created_between`, `updated_between` to the `get_generic_materials` endpoint
* Added filters `certificate_expires_before`, `certificate_expires_after`, `norm_price`, `compliances`, `updated_after`, `updated_before`, `created_after`, `created_before`, `created_between`, `updated_between`, `unique_product_uuid_v2` on `get_products` endpoint
* Released the open-source Python Library `aecdata`

**Version 1.0.1 - 17 April 2024**

* Added thickness, `grey_energy_total`, `grey_energy_fabrication_total`, `grey_energy_recovery_fabrication`, `grey_energy_material_recovery_fabrication`, `grey_energy_elimination`, created, updated to the `get_generic_materials` endpoint


---

# 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/resources/version-log.md?ask=<question>
```

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.
