> For the complete documentation index, see [llms.txt](https://docs.2050-materials.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.2050-materials.com/resources/version-log.md).

# Version Log

Sorted by latest shown on top

Version numbers count production releases of the 2050 Materials platform, API and these docs together. From version 1.0.52, changes that can change what an API integration receives are marked **Breaking**.

**Version 1.0.57 - 20th November 2026**

* The docs home page and the [Quick Reference for AI Agents](https://docs.2050-materials.com/using-the-2050-materials-api/quick-reference-for-ai-agents.md) now link this Version Log.
* The Swagger UI at `/developer/documentation-ui/` is now the parameter reference, linked from each endpoint page, and the [Field Dictionary](https://docs.2050-materials.com/methodology-documentation/field-dictionary.md) lists every response field. The API does not change. If you generate code from `/developer/schema.json`, some parameter names in the schema change: `product_type(s)` is now `product_type`, `material_types(s)` is now `material_type`, and the `{field}__min / {field}__max` ranges are described on each operation instead of as one parameter.
* For generic materials, `total_biogenic_co2e` and `transport_to_site` match `lca_fields` only when `lca_fields` has that row. The values do not change. See [Generic Material Data](https://docs.2050-materials.com/using-the-2050-materials-api/available-endpoints/generic-material-data.md).
* **Breaking:** `sort_by` on `get_products`, `get_products_open_api` and `get_generic_materials` accepts only the values the documentation lists, and a request that sorts on any other field name returns 400. More values now work, for example `id`, `description`, `density_estimated`, `data_source_year` and `material_type_family`. If you sort on a field that is not listed, switch to a listed one. See [Product Data (Full)](https://docs.2050-materials.com/using-the-2050-materials-api/available-endpoints/product-data-full.md).
* **Breaking:** the `declared_unit` filter on `get_products`, `get_generic_materials` and `get_best_match` takes a unit id, or the unit matched exactly, ignoring case: `m` no longer matches `m2` or `m3`. `functional_unit_unit` (deprecated) takes the same values, including the published id. Send the full unit, or its id from the filters endpoint. See [Product Data (Full)](https://docs.2050-materials.com/using-the-2050-materials-api/available-endpoints/product-data-full.md).
* **Breaking:** `is_private_product=false` on `get_products`, and in `product_filters` in `get_best_match`, returns every public product you can see, not only your company's own public products. `get_generic_materials` now also returns your company's own verified public materials, with no parameter or with `is_private_material=false`. For an account without a company, `is_private_product=true` and `is_private_material=true` return no results. If you use these filters, check your results. See [Product Data (Full)](https://docs.2050-materials.com/using-the-2050-materials-api/available-endpoints/product-data-full.md) and [Generic Material Data](https://docs.2050-materials.com/using-the-2050-materials-api/available-endpoints/generic-material-data.md).
* **Breaking:** on products, the `compliances` and `epd_operator` filters match one value from the product filters endpoint exactly, ignoring case, instead of any text that contains it. For example, `compliances=LEED` no longer returns products that state only `LEED v4`, and each option's count now equals the number of products the filter returns. If you send partial text, send the full value from the filters endpoint instead. See [Product Data (Full)](https://docs.2050-materials.com/using-the-2050-materials-api/available-endpoints/product-data-full.md).
* Generic materials now return the `lca_fields` rows for A4 (transport to site), biogenic GWP and ODP whenever the flat field has a value. The flat values do not change. About 6,000 materials get these rows and a new `updated` time, so clients that sync with `updated_after` fetch them again once. See [Generic Material Data](https://docs.2050-materials.com/using-the-2050-materials-api/available-endpoints/generic-material-data.md).
* The [Quick Reference for AI Agents](https://docs.2050-materials.com/using-the-2050-materials-api/quick-reference-for-ai-agents.md) lists every `get_generic_materials` filter and the A1–A3 field.
* Products can now come from EPDs uploaded directly on the 2050 Materials platform. They carry the new source `user_upload`, which the `source` filter of `get_products` accepts. See [Data Sources](https://docs.2050-materials.com/data-documentation/data-sources.md).
* The docs now say which account each API endpoint needs and what its limits are. Free accounts can now also call `get_generic_material_filters`. For `get_best_match` we recommend about 20 input items per request, and the docs explain what the match scores mean and why a request should not be sent twice. See [Using the 2050 Materials API](https://docs.2050-materials.com/using-the-2050-materials-api.md) and [Automated Mapping (get\_best\_match)](https://docs.2050-materials.com/using-the-2050-materials-api/available-endpoints/automated-mapping-get-best-match.md).
* The docs are reorganised around four starting points: Get data, Understand a value, Trust the data and What changed. Some page addresses changed; every old address redirects to the new one.
* Trial accounts get at most 5 results, page 1 only, without `page_size`, on `get_products` and `get_generic_materials`; the access table and endpoint pages now say so.
* The methodology pages now give the biogenic correction's formula and conditions with a worked timber example, the A4 and C2 defaults, and the unit conversion fields. See [Calculated Metrics (Biogenic Emissions)](https://docs.2050-materials.com/methodology-documentation/calculated-metrics-biogenic-emissions.md).
* `token/refresh` returns `{"api_token": "..."}` only and needs the body `{"refresh": "<refresh token>"}`; the [Quick Reference for AI Agents](https://docs.2050-materials.com/using-the-2050-materials-api/quick-reference-for-ai-agents.md) and the [Code Examples](https://docs.2050-materials.com/using-the-2050-materials-api/sdks/code-examples.md) now say so and describe the filter option keys.
* Every Swagger UI link now has a `schema.json` link next to it (`https://app.2050-materials.com/developer/schema.json`), for agents and scripts that can't read the Swagger page.
* Corrected statements on the data enrichment, data import, benchmarks and optimiser tool pages.
* The [Field Dictionary](https://docs.2050-materials.com/methodology-documentation/field-dictionary.md) is now one page per endpoint, plus sample responses, so each page can be read in one fetch. Sections with many fields have sub-headings, and the common null and presence rules are stated once per page. The endpoint pages link their field dictionary page and sample response.
* The corrected carbon values and the classification of 56 bio-based generic materials (mainly timber, wood-based boards and insulation, cork, linoleum and laminate) are corrected. Their corrected totals now exclude the biogenic carbon at both ends, as for other bio-based materials, and they have specific material and product types instead of "Multiple". No action is needed.

**Version 1.0.56 - 16th November 2026**

* **Breaking for schema readers:** the machine-readable API schema at `https://app.2050-materials.com/developer/schema.json` keeps its URL but is now OpenAPI 3.0 instead of Swagger 2.0. If a tool reads this file and supports only Swagger 2.0 (a code generator or an API client importer), update it or switch it to an OpenAPI 3.0 importer. API requests and responses do not change. The schema now also describes the `get_best_match` response. See [Automated Mapping (get\_best\_match)](https://docs.2050-materials.com/using-the-2050-materials-api/available-endpoints/automated-mapping-get-best-match.md).
* Added a [Field Dictionary](https://docs.2050-materials.com/methodology-documentation/field-dictionary.md): every response field of `get_products`, `get_products_open_api` and `get_generic_materials`, with its JSON path, type, unit and meaning. The API schema now lists fields that responses already returned, describes `scaling_factors` as an object keyed by unit code, and corrects six types (`get_products_open_api` `material_facts.manufacturing` is a string; `get_products` `u_value`, `porosity`, `compression_strength`, `impact_strength` and `life_expectancy` are numbers). Responses are unchanged. If your client is generated from the schema, regenerate it.
* Added a page on [product and material statuses](https://docs.2050-materials.com/data-documentation/product-and-material-statuses.md), and linked it from the endpoint pages. It describes existing behaviour.
* Endpoint and methodology pages now match the Field Dictionary: unit statements that the API does not confirm were removed, and field descriptions were corrected.
* Corrected wrong and conflicting statements across the API, methodology and code-example pages.
* Every page now has a short description, and headings have fixed anchors, so links to a section keep working. The [Quick Reference for AI Agents](https://docs.2050-materials.com/using-the-2050-materials-api/quick-reference-for-ai-agents.md) is the entry point for agents.

**Version 1.0.55 - 11th November 2026**

* Added the EPD's recycled-content split to `material_facts` on the product data endpoint: `recycled_content_pre_consumer`, `recycled_content_post_consumer` and `recycled_content_total`, in percent of the product. Each is present only when the EPD states it, and a stated 0 is returned as 0. `recycled_content` is unchanged. See [Product Data (Full)](https://docs.2050-materials.com/using-the-2050-materials-api/available-endpoints/product-data-full.md).
* Added provenance and Uniclass filters to the generic material data endpoint and to `material_filters` in automated mapping: `compliances`, `geographical_scope` (a country code such as `DE`, a regional code such as `RER`, or a country name), `data_year__min` / `__max`, `valid_until_year__min` / `__max`, `certificate_subtype`, `epd_operator`, `lca_database`, `verification_type`, `uniclass_systems`, `uniclass_products` and `uniclass_materials`. For example, `compliances=EN%2015804%2BA2&geographical_scope=Germany&valid_until_year__min=2028` (encode `+` as `%2B` in a URL). See [Generic Material Data](https://docs.2050-materials.com/using-the-2050-materials-api/available-endpoints/generic-material-data.md).
* `total_co2e_kg_mf_corrected` now always agrees with the corrected stages when A1–A3 is negative, on both the product and the generic material data endpoints. Where the biogenic correction can't be applied (for example a timber product declared in m³ with no density), it used to repeat `total_co2e_kg_mf` while `manufacturing_corrected` was floored at zero, so the two disagreed. The stage fields are unchanged; affected products and generic materials have a new `updated` date.
* `recyclable_content`, `energy_recovery_possibility` and `reuse_potential` are now end-of-life values, on the product data and generic material data endpoints and on the platform. Each is the EPD's materials for recycling, materials for energy recovery or components for re-use at end of life (C1–C4, or the C1–C4 total when the EPD does not split it), as a percentage of the declared unit mass. They used to be read from A1–A3, which is waste from manufacturing, not the product at end of life.
* Values change for every product and generic material whose EPD declares these flows. A product whose EPD declares them only for A1–A3 now has no value. `recycled_content` (secondary material in A1–A3) does not change. No fields were added, removed or renamed. `updated` was bumped on the affected products and generic materials, so clients syncing with `updated_after` pick up the new values, and saved project reports have been recalculated.
* These percentages, and `recycled_content`, are divided by the stated `mass_per_declared_unit`, else by `scaling_factors.kg.value`. When `mass_per_declared_unit` is absent and `scaling_factors.kg.estimated` is `true`, the percentages are estimated as well. Product pages mark them with (≈).
* Added `reference_service_life_years` and `end_of_life_scenario` to `material_facts` on the product data endpoint. `reference_service_life_years` is the EPD's reference service life in years, separate from the product-level `life_expectancy`. `end_of_life_scenario` gives the end-of-life destinations, shares and C3 / C4 routes the EPD assumes; it is not the same as `end_of_life`, the C1–C4 fossil carbon. Each is present only when the EPD states it. See [Product Data (Full)](https://docs.2050-materials.com/using-the-2050-materials-api/available-endpoints/product-data-full.md).
* Added `use_stage` to `material_facts` on the product data endpoint: the reference service life and study period, and the B2 maintenance, B3 repair, B4 replacement and B5 refurbishment scenarios the EPD assumes, as printed in the EPD. For B2 and B3, `value_basis` says whether the module's values are per year, over the reference service life, over the reference study period or one-off, when the EPD states it, so the values can be scaled to a building's study period. See [Product Data (Full)](https://docs.2050-materials.com/using-the-2050-materials-api/available-endpoints/product-data-full.md).

**Version 1.0.54 - 7th November 2026**

* A product's `end_of_life` (C1–C4) in `get_products` now includes C2 (transport to disposal), the same as generic materials: it is C1 + C2 + C3 + C4 as declared in the EPD. `end_of_life_corrected`, `total_co2e_kg_mf` and `total_co2e_kg_mf_corrected` go up by the same C2 for every product whose EPD declares C2, and so do the results of `end_of_life` and `total_co2e_kg_mf` filters and sorting. No fields were added, removed or renamed. `updated` was bumped on the affected products, so clients syncing with `updated_after` pick up the new values.
* Project results don't change for most products. Projects still replace a product's own C2 with the project's C2 (a calculated 50 km haul with transport emissions enabled, zero with them disabled), and now count it once in C1–C4 for products as well as generic materials. See [C1–C4 end of life](https://docs.2050-materials.com/readme/2050-materials-platform/whole-life-carbon-assessment-methodology.md) (section 4.6).
* Products whose end-of-life value is a C1–C4 total without separate C1, C2, C3 and C4 modules are now treated like generic materials with only a C1–C4 total: the total already includes C2, so projects no longer add a calculated C2 on top. End-of-life results for projects using these products go down by that C2; saved project reports have been recalculated.
* In the Results\_Configuration export, product A4, C2 and C1–C4 rows now show the values the project report uses, with the same transport basis labels as generic materials.

**Version 1.0.53 - 4th November 2026**

* Expanded the generic materials database by including [OKOBAUDAT 2024-II](https://www.oekobaudat.de/en.html): 2,594 generic, average and representative datasets, classified by material type and product type.
* Added provenance fields to the generic material data endpoint: `data_year`, `valid_until_year`, `geographical_scope`, `compliances`, `certificate_subtype`, `epd_operator`, `lca_database`, `verification_type`, `verifier_name` and `data_owner`. They are copied as the data source states them, so older entries may not have them.
* Deprecated `carbon_a1a3`, `carbon_a4`, `carbon_a5`, `carbon_b1b5`, `carbon_c1c4` and `freshwater_use_a1a3` on the generic material data endpoint. They are removed on 1 February 2027, together with filtering, sorting and `exclude_nulls` on them; use `manufacturing`, `transport_to_site`, `on_site_installation`, `use_and_maintenance`, `end_of_life` and `water_use_kg`, which have the same values. Responses now carry a `Deprecation` header. See [Deprecated fields](https://docs.2050-materials.com/using-the-2050-materials-api/available-endpoints/generic-material-data.md#output-fields).
* Range filters, `sort_by` and `exclude_nulls` on the generic material data endpoint accept every `lca_fields` value, named `{lca_field}__{module}` as on the product API (e.g. `global_warming_potential_fossil__A1A2A3__max=10`). The per-module filters `carbon_a1` to `carbon_d` are deprecated and removed on 1 February 2027; see [Generic Material Data](https://docs.2050-materials.com/using-the-2050-materials-api/available-endpoints/generic-material-data.md) for where the results differ.
* "OKOBAUDAT (English)" and "OKOBAUDAT (English) - 2024" are no longer offered from 1 January 2027: they leave the API, search and the project material picker, and projects that already use them keep them with unchanged results.

**Version 1.0.52 - 4th November 2026**

* **Breaking:** on the product data endpoint, `material_facts.mass_per_declared_unit` now holds only a mass the EPD or the manufacturer states (or 1 for a kg declared unit). It is no longer estimated or derived from density, grammage, linear density or mass per piece, so it is absent for products without a stated mass, and the `mass_per_declared_unit` range filter matches fewer products. Read `material_facts.scaling_factors.kg.value` for the best available mass, and `scaling_factors.kg.estimated` for whether it is estimated.
* The same rule applies to generic materials: `mass_per_declared_unit` is a stated value only, and `scaling_factors.kg` carries the derived mass.
* `mass_per_declared_unit_estimated` is deprecated on both endpoints. It is always `false` and is removed in a later release.
* Added `exclude_legacy` to the generic material data endpoint (default `true`), as on the product API. No generic materials are marked legacy yet.

**Version 1.0.51 - 4th November 2026**

* Added `scaling_factors` to the generic material data endpoint: the unit conversions for each material, in the same shape as the product API. See [Unit conversion](https://docs.2050-materials.com/using-the-2050-materials-api/available-endpoints/generic-material-data.md#unit-conversion-scaling_factors).
* Generic materials with an ODP of zero now return `odp` as `"0.0"`. The field used to be left out for them.

**Version 1.0.50 - 3rd November 2026**

* Projects no longer count end-of-life transport (C2) twice for generic materials. A generic material's C1–C4 total already includes C2, and projects with transport emissions enabled were adding a calculated C2 on top. End-of-life results (and B4 replacement) for those projects go down; saved project reports have been recalculated. Generic materials that publish all four C modules (for example OKOBAUDAT 2024-II) now use the calculated 50 km C2 in place of their published C2. See [C1–C4 end of life](https://docs.2050-materials.com/readme/2050-materials-platform/whole-life-carbon-assessment-methodology.md) (section 4.6).
* Project dashboards and the Results\_Configuration export now show where each generic-material row's A4 and C2 came from.

**Version 1.0.49 - 27th October 2026**

* Added `lca_fields` to the generic material data endpoint: the per-module LCA breakdown of each material (metric name to `{module: value}`), in the same shape as the product API. See [LCA breakdown](https://docs.2050-materials.com/using-the-2050-materials-api/available-endpoints/generic-material-data.md#lca-breakdown-lca_fields).
* The harmonised generic material fields (`manufacturing`, `transport_to_site`, `on_site_installation`, `use_and_maintenance`, `end_of_life`, `water_use_kg` and the `*_corrected` fields) are now updated whenever a material changes, instead of weekly.

**Version 1.0.48 - 25th October 2026**

* `get_products` filters now accept both the `id` and the `value` returned by `get_product_filters`. For `fire_performance` the option `id` is now the class string itself (e.g. `"A1"`) instead of a number, and option counts match the products the filter returns. `norm_price` accepts the label (e.g. `££`) as well as the id.
* `icms_classifications`, `nrm1_classifications` and `rics_wlca_classifications` filters now match the classification code or name exactly (case-insensitive), on `get_products`, `get_generic_materials` and `get_best_match`. Codes used to match as substrings, so `NRM1_5_1` also returned `NRM1_5_10` to `NRM1_5_14`, and a group code such as `B_01` returned every `B_01_*` sub-group.

**Version 1.0.47 - 19th October 2026**

* Added harmonised fields to the generic material data endpoint, matching the product API names: `manufacturing`, `transport_to_site`, `on_site_installation`, `use_and_maintenance`, `end_of_life`, `water_use_kg`, and the biogenic-corrected `manufacturing_corrected`, `end_of_life_corrected`, `total_co2e_kg_mf_corrected`, `total_biogenic_co2e_corrected`. The existing `carbon_*` and `freshwater_use_a1a3` fields remain the recommended fields for now.
* Added `carbon_a4` (default transport-to-site emissions from the data source) to the generic material data endpoint.

**Version 1.0.46 - 7th October 2026**

* Added declared unit methodology
* Expanded the generic materials database by including [SEAI Irish National EC Database of Generic Building Materials](https://www.seai.ie/sites/default/files/publications/EC-Database-Generic-Building-Materials.xlsx)

**Version 1.0.45 - 25th September 2026**

* Updated the ODP values from reporting in mg CFC 11-equivalent to kg CFC 11-equivalent

**Version 1.0.44 - 17th September 2026**

* Updated the product data fields to include `icms_classifications`, `rics_wlca_classifications`, `global_warming_potential_aggregate_calculated`, `life_expectancy_estimated`, `verifier_name`, `verifier_email`, `verification_type`, `lca_tool`, `lca_database`, `lca_consultant` and `epd_operator`.

**Version 1.0.43 - 20th August 2026**

* Expanded the generic materials database by including [KBOB (V9)](https://www.kbob.admin.ch/de/oekobilanzdaten-im-baubereich)

**Version 1.0.42 - 12th August 2026**

* Expanded the generic materials database by including the [PlasticsEurope](https://plasticseurope.org/) datasets and [NABERS National Material Emission Factors v2026.2 (Default, uncertainty-adjusted) - Oceania](https://www.nabers.gov.au/publications/national-emission-factors-database)
* Reordered all product fields to alphabetical order for easier viewing

**Version 1.0.41 - 30th July 2026**

* Updated the fallback values to include detail about key physical and technical properties

**Version 1.0.40 - 21st July 2026**

* Added a unit conversion table

**Version 1.0.39 - 6th July 2026**

* Expanded the generic materials database by including [Finnish Environment Institute (SYKE) CO2data - Emissions Database for Building Construction v1.01.008](https://co2data.fi/rakentaminen/), [New Zealand Environment Ministry - GHG Factors (2026.2)](https://measuringemissionsguide.environment.govt.nz/files_download.html), [Australian National Greenhouse Accounts Factors (July 2025)](https://www.dcceew.gov.au/climate-change/publications/national-greenhouse-accounts-factors-2025), [The Concrete Centre - LCCG Market Benchmark v4.0 (2025 Update)](https://www.concretecentre.com/TCC/media/TCCMediaLibrary/Events/Concrete%20Compass/LCCG-Market-Benchmark-v4-0-2025-Update.xlsx), [UK Government GHG Conversion Factors for Company Reporting, 2026](https://www.gov.uk/government/publications/greenhouse-gas-reporting-conversion-factors-2026), [Conventions for New Homes Materials Dataset 2026 (Future Homes Hub)](https://www.futurehomes.org.uk/), [New Homes Assembly/Benchmark Dataset 2026 (Future Homes Hub)](https://www.futurehomes.org.uk/)

**Version 1.0.38 - 7th May 2026**

* Added whole life carbon assessment methodology

**Version 1.0.37 - 22nd April 2026**

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

**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 and included additional details on the Generic Materials table for number of materials in the database and whether it is uploaded or generated

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

**Data update - 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.md) 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/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`
  * 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](https://docs.2050-materials.com/data-documentation/data-sources.md) table 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/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](https://docs.2050-materials.com/using-the-2050-materials-api/available-endpoints/generic-material-data.md) endpoint (see [Data Sources](https://docs.2050-materials.com/data-documentation/data-sources.md)).

**Version 1.0.22 - 26th June 2025**

* Updated [data sources](https://docs.2050-materials.com/data-documentation/data-sources.md) 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/using-the-2050-materials-api/available-endpoints/product-data-full.md#product-fields).

**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_products` 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, and data\_source 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
