Climate v2.0 | Dokumentation

General Information

This endpoint is used to retrieve climate data related to construction products. It includes information sourced from EPDs (Environmental Product Declarations), calculations based on these, as well as supplementary values derived from the Swedish National Board of Housing, Building and Planning’s (Boverket) climate database. The API supports both precise climate data when EPDs are available, and generic default data when necessary.

Time-Based Retrieval

If no time parameters are specified, only the date will be considered.
All dates are inclusive, including both from and to.
If time is also specified, it must be provided in UTC format (e.g., 2023-07-05T12:17:30.974Z)
If only from is specified, to is assumed to be the current time.

finfoSupplierId without an accompanying variable
changed-from-date

Additional Notes

supplierArticleId requires that finfoSupplierId is also specified.

If the variable changed-from-date is used, the response will be filtered based on the recipient’s specific suppliers.

When other variables are used, the response may include articles that do not belong to the recipient’s specific suppliers. In such cases, matching against finfoArticleId may be required.

Deviations from v1.0/climate

The values for GWP-GHG previously extracted from EPDs were named epdA1…epdA5. These have now been replaced by extractedFromEpd.epdDataGwpGhgA.epdGwpGhgA1…extractedFromEpd.epdDataGwpGhgA.epdGwpGhgA5

Response formatting (JSON)

JSON

{
  "pagination": {
    "offset": 0,
    "limit": 0,
    "totalCount": 0
  },
  "articleList": [
    {
      "epdMetaData": {},
      "extractedFromEpd": {},
      "calculatedFromEpd": {},
      "boverketData": {}
    }
  ]
}

1. pagination

Used to handle pagination of the results.

offset: Starting index for the results.
limit: Number of items per request.
totalCount: Total number of matches in the database.

2. articleList

A list of articles containing climate data. Each article includes:

2.1 epdMetaData

Metadata from the EPD (Environmental Product Declaration).

finfoNumber: Internal article number in Finfo.
identifiers: Identifiers.
- finfoSupplierId: Finfo’s supplier ID.
- supplierArticleId: Supplier’s article number.
- gtin: The article’s GTIN (Global Trade Item Number).
epdAssetLink: URL to the EPD document (PDF).
epdLastModified: Date when the EPD was last updated.
epdOwner: Organization that owns the EPD (often the manufacturer).
epdValidTo: Expiry date of the EPD’s validity period.
epdModel: Product model (if available).
epdProductName: Product name according to the EPD.
epdPublisher: Publishing EPD program (e.g., The International EPD System).
epdId: Unique ID of the EPD.
epdStandard: Standard according to which the EPD was developed (e.g., EN 15804:2012+A2:2019).
epdFunctionalUnit: Functional unit, e.g., “1 m²”.
epdFunctionalUnitWeight: Weight per functional unit (e.g., kg/m²).
epdComment: Comments from the EPD.
externalDatasetId: External ID in another database.
externalDatasetUrl: Link to an external source (e.g., EPD International).

2.2 extractedFromEpd

Raw data directly extracted from the EPD.

epdDataGwpGhg[A–D]: Total GWP values per module A–D (Global Warming Potential, all greenhouse gases).
epdDataGwp[A–D]: Detailed breakdown of GWP per module.
- May include, for example: GWP-fossil, GWP-biogen, GWP-luluc.
- Compliant with the EN15804 A2-standard.

2.3 calculatedFromEpd

Recalculations based on EPD data.

byGtin.gtin: Specifies the GTIN for which the calculations apply.
epdCalculation[A–D]: Emission calculations per life cycle module (A–D), recalculated into various units:
- Examples include: kg CO2e per kg, per m2, per liter or per förpackning.
- May include calculations from modules A1–A3, A4, A5.

2.4 boverketData

Climate data based on the Swedish National Board of Housing, Building and Planning’s (Boverket) climate database (default values).

boverketResourceId: ID of the resource in Boverket’s database.
boverketDataA: Raw data per module (typically A1–A3, A4, A5) based on default values.
boverketCalculationA: Recalculated default data in alternative units (e.g., kg CO₂e per m²).

Important Information

If a section is empty, only the section header is included.
f a section is present, it will contain all fields—even those with null values.
This means, for example, that epdCalculationA1M2 may have a value of null even if the section is displayed.

About EPDs and Climate Data

EPDs (Environmental Product Declarations) are third-party verified documents that disclose the environmental impact of a construction product. They follow standards such as EN 15804 and are used to support climate impact assessments. The Swedish National Board of Housing, Building and Planning (Boverket) provides a climate database containing default values, which are used when an EPD is not available.

Relevant sources:

Boverket: https://www.boverket.se/sv/klimatdeklaration/
EPD International: https://www.environdec.com/
IVL Svenska Miljöinstitutet: https://www.ivl.se/

Example of an API response (JSON)