Create environmental impact

curl --request POST \
  --url https://www.closient.com/sustainability/api/v1/environmental-impacts \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "assessment_date": "2026-04-15",
  "gtin": "00850012345688",
  "impact_type": "CARBON_FOOTPRINT",
  "methodology_reference": "ISO 14067:2018",
  "notes": "Cradle-to-gate assessment including transport.",
  "score_value": 2.4,
  "unit": "kg CO2e"
}
'

import requests

url = "https://www.closient.com/sustainability/api/v1/environmental-impacts"

payload = {
    "assessment_date": "2026-04-15",
    "gtin": "00850012345688",
    "impact_type": "CARBON_FOOTPRINT",
    "methodology_reference": "ISO 14067:2018",
    "notes": "Cradle-to-gate assessment including transport.",
    "score_value": 2.4,
    "unit": "kg CO2e"
}
headers = {
    "X-API-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    assessment_date: '2026-04-15',
    gtin: '00850012345688',
    impact_type: 'CARBON_FOOTPRINT',
    methodology_reference: 'ISO 14067:2018',
    notes: 'Cradle-to-gate assessment including transport.',
    score_value: 2.4,
    unit: 'kg CO2e'
  })
};

fetch('https://www.closient.com/sustainability/api/v1/environmental-impacts', 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://www.closient.com/sustainability/api/v1/environmental-impacts",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'assessment_date' => '2026-04-15',
    'gtin' => '00850012345688',
    'impact_type' => 'CARBON_FOOTPRINT',
    'methodology_reference' => 'ISO 14067:2018',
    'notes' => 'Cradle-to-gate assessment including transport.',
    'score_value' => 2.4,
    'unit' => 'kg CO2e'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://www.closient.com/sustainability/api/v1/environmental-impacts"

	payload := strings.NewReader("{\n  \"assessment_date\": \"2026-04-15\",\n  \"gtin\": \"00850012345688\",\n  \"impact_type\": \"CARBON_FOOTPRINT\",\n  \"methodology_reference\": \"ISO 14067:2018\",\n  \"notes\": \"Cradle-to-gate assessment including transport.\",\n  \"score_value\": 2.4,\n  \"unit\": \"kg CO2e\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-API-Key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://www.closient.com/sustainability/api/v1/environmental-impacts")
  .header("X-API-Key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"assessment_date\": \"2026-04-15\",\n  \"gtin\": \"00850012345688\",\n  \"impact_type\": \"CARBON_FOOTPRINT\",\n  \"methodology_reference\": \"ISO 14067:2018\",\n  \"notes\": \"Cradle-to-gate assessment including transport.\",\n  \"score_value\": 2.4,\n  \"unit\": \"kg CO2e\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://www.closient.com/sustainability/api/v1/environmental-impacts")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"assessment_date\": \"2026-04-15\",\n  \"gtin\": \"00850012345688\",\n  \"impact_type\": \"CARBON_FOOTPRINT\",\n  \"methodology_reference\": \"ISO 14067:2018\",\n  \"notes\": \"Cradle-to-gate assessment including transport.\",\n  \"score_value\": 2.4,\n  \"unit\": \"kg CO2e\"\n}"

response = http.request(request)
puts response.read_body

{
  "assessment_date": "2026-04-15",
  "created": "2026-09-30T09:00:00Z",
  "gtin": "00850012345688",
  "id": "F5n5NdW6dTbvPYkgnLNjte",
  "impact_type": "CARBON_FOOTPRINT",
  "methodology_reference": "ISO 14067:2018",
  "modified": "2026-09-30T09:00:00Z",
  "notes": "Cradle-to-gate assessment including transport.",
  "organization_id": "9fHkqR2aXcVbNmLpQwErTy",
  "score_value": 2.4,
  "unit": "kg CO2e"
}

{
  "detail": "The requested resource was not found.",
  "error_code": "not_found",
  "retryable": false,
  "status": 404,
  "timestamp": "2026-03-31T12:00:00+00:00",
  "title": "Not Found",
  "type": "https://closient.com/docs/errors/not_found"
}

{
  "detail": "The requested resource was not found.",
  "error_code": "not_found",
  "retryable": false,
  "status": 404,
  "timestamp": "2026-03-31T12:00:00+00:00",
  "title": "Not Found",
  "type": "https://closient.com/docs/errors/not_found"
}

{
  "detail": "The requested resource was not found.",
  "error_code": "not_found",
  "retryable": false,
  "status": 404,
  "timestamp": "2026-03-31T12:00:00+00:00",
  "title": "Not Found",
  "type": "https://closient.com/docs/errors/not_found"
}

{
  "detail": "The requested resource was not found.",
  "error_code": "not_found",
  "retryable": false,
  "status": 404,
  "timestamp": "2026-03-31T12:00:00+00:00",
  "title": "Not Found",
  "type": "https://closient.com/docs/errors/not_found"
}

{
  "detail": "The requested resource was not found.",
  "error_code": "not_found",
  "retryable": false,
  "status": 404,
  "timestamp": "2026-03-31T12:00:00+00:00",
  "title": "Not Found",
  "type": "https://closient.com/docs/errors/not_found"
}

{
  "detail": "The requested resource was not found.",
  "error_code": "not_found",
  "retryable": false,
  "status": 404,
  "timestamp": "2026-03-31T12:00:00+00:00",
  "title": "Not Found",
  "type": "https://closient.com/docs/errors/not_found"
}

{
  "detail": "The requested resource was not found.",
  "error_code": "not_found",
  "retryable": false,
  "status": 404,
  "timestamp": "2026-03-31T12:00:00+00:00",
  "title": "Not Found",
  "type": "https://closient.com/docs/errors/not_found"
}

{
  "detail": "The requested resource was not found.",
  "error_code": "not_found",
  "retryable": false,
  "status": 404,
  "timestamp": "2026-03-31T12:00:00+00:00",
  "title": "Not Found",
  "type": "https://closient.com/docs/errors/not_found"
}

POST

sustainability

api

environmental-impacts

Create environmental impact

curl --request POST \
  --url https://www.closient.com/sustainability/api/v1/environmental-impacts \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "assessment_date": "2026-04-15",
  "gtin": "00850012345688",
  "impact_type": "CARBON_FOOTPRINT",
  "methodology_reference": "ISO 14067:2018",
  "notes": "Cradle-to-gate assessment including transport.",
  "score_value": 2.4,
  "unit": "kg CO2e"
}
'

import requests

url = "https://www.closient.com/sustainability/api/v1/environmental-impacts"

payload = {
    "assessment_date": "2026-04-15",
    "gtin": "00850012345688",
    "impact_type": "CARBON_FOOTPRINT",
    "methodology_reference": "ISO 14067:2018",
    "notes": "Cradle-to-gate assessment including transport.",
    "score_value": 2.4,
    "unit": "kg CO2e"
}
headers = {
    "X-API-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    assessment_date: '2026-04-15',
    gtin: '00850012345688',
    impact_type: 'CARBON_FOOTPRINT',
    methodology_reference: 'ISO 14067:2018',
    notes: 'Cradle-to-gate assessment including transport.',
    score_value: 2.4,
    unit: 'kg CO2e'
  })
};

fetch('https://www.closient.com/sustainability/api/v1/environmental-impacts', 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://www.closient.com/sustainability/api/v1/environmental-impacts",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'assessment_date' => '2026-04-15',
    'gtin' => '00850012345688',
    'impact_type' => 'CARBON_FOOTPRINT',
    'methodology_reference' => 'ISO 14067:2018',
    'notes' => 'Cradle-to-gate assessment including transport.',
    'score_value' => 2.4,
    'unit' => 'kg CO2e'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://www.closient.com/sustainability/api/v1/environmental-impacts"

	payload := strings.NewReader("{\n  \"assessment_date\": \"2026-04-15\",\n  \"gtin\": \"00850012345688\",\n  \"impact_type\": \"CARBON_FOOTPRINT\",\n  \"methodology_reference\": \"ISO 14067:2018\",\n  \"notes\": \"Cradle-to-gate assessment including transport.\",\n  \"score_value\": 2.4,\n  \"unit\": \"kg CO2e\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-API-Key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://www.closient.com/sustainability/api/v1/environmental-impacts")
  .header("X-API-Key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"assessment_date\": \"2026-04-15\",\n  \"gtin\": \"00850012345688\",\n  \"impact_type\": \"CARBON_FOOTPRINT\",\n  \"methodology_reference\": \"ISO 14067:2018\",\n  \"notes\": \"Cradle-to-gate assessment including transport.\",\n  \"score_value\": 2.4,\n  \"unit\": \"kg CO2e\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://www.closient.com/sustainability/api/v1/environmental-impacts")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"assessment_date\": \"2026-04-15\",\n  \"gtin\": \"00850012345688\",\n  \"impact_type\": \"CARBON_FOOTPRINT\",\n  \"methodology_reference\": \"ISO 14067:2018\",\n  \"notes\": \"Cradle-to-gate assessment including transport.\",\n  \"score_value\": 2.4,\n  \"unit\": \"kg CO2e\"\n}"

response = http.request(request)
puts response.read_body

{
  "assessment_date": "2026-04-15",
  "created": "2026-09-30T09:00:00Z",
  "gtin": "00850012345688",
  "id": "F5n5NdW6dTbvPYkgnLNjte",
  "impact_type": "CARBON_FOOTPRINT",
  "methodology_reference": "ISO 14067:2018",
  "modified": "2026-09-30T09:00:00Z",
  "notes": "Cradle-to-gate assessment including transport.",
  "organization_id": "9fHkqR2aXcVbNmLpQwErTy",
  "score_value": 2.4,
  "unit": "kg CO2e"
}

{
  "detail": "The requested resource was not found.",
  "error_code": "not_found",
  "retryable": false,
  "status": 404,
  "timestamp": "2026-03-31T12:00:00+00:00",
  "title": "Not Found",
  "type": "https://closient.com/docs/errors/not_found"
}

{
  "detail": "The requested resource was not found.",
  "error_code": "not_found",
  "retryable": false,
  "status": 404,
  "timestamp": "2026-03-31T12:00:00+00:00",
  "title": "Not Found",
  "type": "https://closient.com/docs/errors/not_found"
}

{
  "detail": "The requested resource was not found.",
  "error_code": "not_found",
  "retryable": false,
  "status": 404,
  "timestamp": "2026-03-31T12:00:00+00:00",
  "title": "Not Found",
  "type": "https://closient.com/docs/errors/not_found"
}

{
  "detail": "The requested resource was not found.",
  "error_code": "not_found",
  "retryable": false,
  "status": 404,
  "timestamp": "2026-03-31T12:00:00+00:00",
  "title": "Not Found",
  "type": "https://closient.com/docs/errors/not_found"
}

{
  "detail": "The requested resource was not found.",
  "error_code": "not_found",
  "retryable": false,
  "status": 404,
  "timestamp": "2026-03-31T12:00:00+00:00",
  "title": "Not Found",
  "type": "https://closient.com/docs/errors/not_found"
}

{
  "detail": "The requested resource was not found.",
  "error_code": "not_found",
  "retryable": false,
  "status": 404,
  "timestamp": "2026-03-31T12:00:00+00:00",
  "title": "Not Found",
  "type": "https://closient.com/docs/errors/not_found"
}

{
  "detail": "The requested resource was not found.",
  "error_code": "not_found",
  "retryable": false,
  "status": 404,
  "timestamp": "2026-03-31T12:00:00+00:00",
  "title": "Not Found",
  "type": "https://closient.com/docs/errors/not_found"
}

{
  "detail": "The requested resource was not found.",
  "error_code": "not_found",
  "retryable": false,
  "status": 404,
  "timestamp": "2026-03-31T12:00:00+00:00",
  "title": "Not Found",
  "type": "https://closient.com/docs/errors/not_found"
}

Authorizations

X-API-Key

string

header

required

Body

application/json

Payload for POST /environmental-impacts.

gtin

string<gtin>

required

GTIN (8, 12, 13 or 14 digits) of the product. Must be a product the caller's organization owns, else 404.

Required string length: 8 - 14

impact_type

enum<string>

required

Category of environmental effect measured.

Available options:

CARBON_FOOTPRINT,

WATER_USAGE,

ENERGY_CONSUMPTION,

WASTE_GENERATION,

LAND_USE,

OTHER

score_value

number

required

Magnitude of the impact in unit, up to four decimal places.

Required range: -99999999999 <= x <= 99999999999

unit

string

required

Unit score_value is expressed in.

Required string length: 1 - 10

Pattern: ^(kg\ CO2e|kg|t|L|m³|m²|MJ|kWh|%|Other)$

Example:

"kg CO2e"

methodology_reference

string

default:""

Standard or method used, for example GHG Protocol.

Maximum string length: 200

Pattern: ^[^\x00]{0,200}$

assessment_date

string<date> | null

Date of the assessment.

notes

string

default:""

Scope, assumptions or data source.

Maximum string length: 1000

Pattern: ^[^\x00]{0,1000}$

Response

Created

A quantified environmental impact of one of the organization's products.

string<shortuuid>

required

URL-safe 22-character shortuuid encoding of the row's UUID primary key. Stable across the row's lifetime; suitable for sharing in URLs, log lines, and external SDK clients. Accepted on input as either the shortuuid form or the canonical UUID form (xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx).

Required string length: 22

Pattern: ^[23456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22}$

organization_id

string<shortuuid>

required

The organization that owns the product.

Required string length: 22

Pattern: ^[23456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22}$

gtin

string

required

The product's GTIN, normalized to GTIN-14.

created

string<date-time>

required

Server-side ISO 8601 timestamp of creation (UTC).

modified

string<date-time>

required

Server-side ISO 8601 timestamp of last modification (UTC).

impact_type

string

required

Category of environmental effect measured.

score_value

number

required

Magnitude of the impact, expressed in unit.

unit

string

required

Unit score_value is expressed in.

methodology_reference

string

required

Standard or method used. Empty when unset.

assessment_date

string<date> | null

required

Date of the assessment. Null when unset.

notes

string

required

Scope, assumptions or data source. Empty when unset.

Overview

Account

Products

Brands

Locations

Retailers

Search

GS1 Digital Link

EPCIS 2.0

Integrations

Billing

Scanner

Compliance

Certifications

Sustainability

Notifications

Dashboard

Analytics

Agent

Substances

BYOS

Content

Signals

Create environmental impact

Authorizations

Body

Response