# Version Log

**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. 
* 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` 

**Version 1.0.30 - 18th November 2025**

* Expanded the generic materials database by including the newest [ICE Database (V4.1)](https://docs.2050-materials.com/data-documentation/data-sources) by Circular Ecology 

**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](https://docs.2050-materials.com/readme/using-the-2050-materials-api/available-endpoints/product-data-full#filtering-the-data))
* Included "city" under `get_product_filters` and enabled filtering by the same field on `get_products` 
  * 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](https://docs.2050-materials.com/readme/using-the-2050-materials-api/available-endpoints/generic-material-data "mention") 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](https://docs.2050-materials.com/readme/using-the-2050-materials-api/available-endpoints/generic-material-data "mention") 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](https://docs.2050-materials.com/readme/using-the-2050-materials-api/available-endpoints/generic-material-data "mention") 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. 
* 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](https://docs.2050-materials.com/readme/using-the-2050-materials-api/available-endpoints/product-data-full#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` 
* 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). 

**Version 1.0.11 - 4th November 2024**

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

**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