Get a PACT v3 footprint
curl --request GET \
--url https://{subdomain}.variable.global/api/pact/3/footprints/{id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://{subdomain}.variable.global/api/pact/3/footprints/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://{subdomain}.variable.global/api/pact/3/footprints/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://{subdomain}.variable.global/api/pact/3/footprints/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://{subdomain}.variable.global/api/pact/3/footprints/{id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://{subdomain}.variable.global/api/pact/3/footprints/{id}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://{subdomain}.variable.global/api/pact/3/footprints/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"data": {
"id": "3f2b8c1e-5d4a-4f6b-9c2e-7a1d0e8b4c55",
"specVersion": "3.0.0",
"status": "Active",
"companyName": "Acme Corp",
"companyIds": [
"urn:uuid:9b1c2d3e-4f5a-4b6c-8d7e-0f1a2b3c4d5e"
],
"productIds": [
"urn:uuid:6f8d6c41-6a3c-4c3e-9a51-0b5c4f1e2d7a"
],
"productNameCompany": "Green Widget",
"productDescription": "A sustainable widget made from recycled materials",
"pcf": {
"declaredUnitOfMeasurement": "liter",
"declaredUnitAmount": "1234.5678",
"productMassPerDeclaredUnit": "1234.5678",
"pcfExcludingBiogenicUptake": "1234.5678",
"pcfIncludingBiogenicUptake": "1234.5678",
"fossilGhgEmissions": "1234.5678",
"fossilCarbonContent": "1234.5678",
"packagingEmissionsIncluded": true,
"ipccCharacterizationFactors": [
"AR6"
],
"crossSectoralStandards": [
"ISO14067"
],
"referencePeriodStart": "2025-01-01T00:00:00.000Z",
"referencePeriodEnd": "2025-01-01T00:00:00.000Z",
"exemptedEmissionsPercent": "1234.5678",
"primaryDataShare": "1234.5678",
"biogenicCarbonContent": "1234.5678",
"recycledCarbonContent": "1234.5678",
"landUseChangeGhgEmissions": "1234.5678",
"landManagementFossilGhgEmissions": "1234.5678",
"landManagementBiogenicCO2Emissions": "1234.5678",
"landManagementBiogenicCO2Removals": "1234.5678",
"biogenicCO2Uptake": "1234.5678",
"biogenicNonCO2Emissions": "1234.5678",
"landAreaOccupation": "1234.5678",
"aircraftGhgEmissions": "1234.5678",
"packagingGhgEmissions": "1234.5678",
"packagingBiogenicCarbonContent": "1234.5678",
"outboundLogisticsGhgEmissions": "1234.5678",
"ccsTechnologicalCO2CaptureIncluded": true,
"ccsTechnologicalCO2Capture": "1234.5678",
"technologicalCO2CaptureOrigin": "<string>",
"technologicalCO2Removals": "1234.5678",
"ccuCarbonContent": "1234.5678",
"ccuCalculationApproach": "Cut-off",
"ccuCreditCertification": "<string>",
"productOrSectorSpecificRules": [
{
"operator": "PEF",
"ruleNames": [
"EN 15804+A2"
]
}
],
"boundaryProcessesDescription": "<string>",
"geographyCountrySubdivision": "US-PA",
"geographyCountry": "NO",
"geographyRegionOrSubregion": "Europe",
"secondaryEmissionFactorSources": [
{
"name": "ecoinvent",
"version": "3.9.1"
}
],
"exemptedEmissionsDescription": "<string>",
"allocationRulesDescription": "<string>",
"dqi": {
"technologicalDQR": "1234.5678",
"temporalDQR": "1234.5678",
"geographicalDQR": "1234.5678"
},
"verification": {
"coverage": "PCF calculation model",
"providerName": "<string>",
"completedAt": "2025-01-01T00:00:00.000Z",
"standardName": "<string>",
"comments": "<string>"
}
},
"created": "2025-01-01T00:00:00.000Z",
"precedingPfIds": [
"<string>"
],
"validityPeriodStart": "2025-01-01T00:00:00.000Z",
"validityPeriodEnd": "2025-01-01T00:00:00.000Z",
"productClassifications": [
"urn:cpc:4299"
],
"comment": "<string>",
"extensions": [
{
"specVersion": "<string>",
"dataSchema": "<string>",
"documentation": "<string>",
"data": {}
}
],
"updated": "2025-01-01T00:00:00.000Z"
}
}{
"message": "token expired",
"code": "TokenExpired"
}{
"message": "The specified footprint does not exist",
"code": "NotFound"
}Endpoints
PACT v3 footprint
Read one footprint by id on PACT v3.
GET
/
pact
/
3
/
footprints
/
{id}
Get a PACT v3 footprint
curl --request GET \
--url https://{subdomain}.variable.global/api/pact/3/footprints/{id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://{subdomain}.variable.global/api/pact/3/footprints/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://{subdomain}.variable.global/api/pact/3/footprints/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://{subdomain}.variable.global/api/pact/3/footprints/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://{subdomain}.variable.global/api/pact/3/footprints/{id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://{subdomain}.variable.global/api/pact/3/footprints/{id}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://{subdomain}.variable.global/api/pact/3/footprints/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"data": {
"id": "3f2b8c1e-5d4a-4f6b-9c2e-7a1d0e8b4c55",
"specVersion": "3.0.0",
"status": "Active",
"companyName": "Acme Corp",
"companyIds": [
"urn:uuid:9b1c2d3e-4f5a-4b6c-8d7e-0f1a2b3c4d5e"
],
"productIds": [
"urn:uuid:6f8d6c41-6a3c-4c3e-9a51-0b5c4f1e2d7a"
],
"productNameCompany": "Green Widget",
"productDescription": "A sustainable widget made from recycled materials",
"pcf": {
"declaredUnitOfMeasurement": "liter",
"declaredUnitAmount": "1234.5678",
"productMassPerDeclaredUnit": "1234.5678",
"pcfExcludingBiogenicUptake": "1234.5678",
"pcfIncludingBiogenicUptake": "1234.5678",
"fossilGhgEmissions": "1234.5678",
"fossilCarbonContent": "1234.5678",
"packagingEmissionsIncluded": true,
"ipccCharacterizationFactors": [
"AR6"
],
"crossSectoralStandards": [
"ISO14067"
],
"referencePeriodStart": "2025-01-01T00:00:00.000Z",
"referencePeriodEnd": "2025-01-01T00:00:00.000Z",
"exemptedEmissionsPercent": "1234.5678",
"primaryDataShare": "1234.5678",
"biogenicCarbonContent": "1234.5678",
"recycledCarbonContent": "1234.5678",
"landUseChangeGhgEmissions": "1234.5678",
"landManagementFossilGhgEmissions": "1234.5678",
"landManagementBiogenicCO2Emissions": "1234.5678",
"landManagementBiogenicCO2Removals": "1234.5678",
"biogenicCO2Uptake": "1234.5678",
"biogenicNonCO2Emissions": "1234.5678",
"landAreaOccupation": "1234.5678",
"aircraftGhgEmissions": "1234.5678",
"packagingGhgEmissions": "1234.5678",
"packagingBiogenicCarbonContent": "1234.5678",
"outboundLogisticsGhgEmissions": "1234.5678",
"ccsTechnologicalCO2CaptureIncluded": true,
"ccsTechnologicalCO2Capture": "1234.5678",
"technologicalCO2CaptureOrigin": "<string>",
"technologicalCO2Removals": "1234.5678",
"ccuCarbonContent": "1234.5678",
"ccuCalculationApproach": "Cut-off",
"ccuCreditCertification": "<string>",
"productOrSectorSpecificRules": [
{
"operator": "PEF",
"ruleNames": [
"EN 15804+A2"
]
}
],
"boundaryProcessesDescription": "<string>",
"geographyCountrySubdivision": "US-PA",
"geographyCountry": "NO",
"geographyRegionOrSubregion": "Europe",
"secondaryEmissionFactorSources": [
{
"name": "ecoinvent",
"version": "3.9.1"
}
],
"exemptedEmissionsDescription": "<string>",
"allocationRulesDescription": "<string>",
"dqi": {
"technologicalDQR": "1234.5678",
"temporalDQR": "1234.5678",
"geographicalDQR": "1234.5678"
},
"verification": {
"coverage": "PCF calculation model",
"providerName": "<string>",
"completedAt": "2025-01-01T00:00:00.000Z",
"standardName": "<string>",
"comments": "<string>"
}
},
"created": "2025-01-01T00:00:00.000Z",
"precedingPfIds": [
"<string>"
],
"validityPeriodStart": "2025-01-01T00:00:00.000Z",
"validityPeriodEnd": "2025-01-01T00:00:00.000Z",
"productClassifications": [
"urn:cpc:4299"
],
"comment": "<string>",
"extensions": [
{
"specVersion": "<string>",
"dataSchema": "<string>",
"documentation": "<string>",
"data": {}
}
],
"updated": "2025-01-01T00:00:00.000Z"
}
}{
"message": "token expired",
"code": "TokenExpired"
}{
"message": "The specified footprint does not exist",
"code": "NotFound"
}A footprint’s
id is its PCF’s id. A PCF that a newer locked version replaced stays retrievable by its id, with
status: "Deprecated".