Create packaging element

curl --request POST \
  --url https://www.closient.com/sustainability/api/v1/packaging \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "description": "500ml PET plastic bottle.",
  "gtin": "00850012345688",
  "is_recyclable": true,
  "is_reusable": false,
  "packaging_type": "primary",
  "recycled_content_percentage": 30,
  "weight_grams": 28.5
}
'

import requests

url = "https://www.closient.com/sustainability/api/v1/packaging"

payload = {
    "description": "500ml PET plastic bottle.",
    "gtin": "00850012345688",
    "is_recyclable": True,
    "is_reusable": False,
    "packaging_type": "primary",
    "recycled_content_percentage": 30,
    "weight_grams": 28.5
}
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({
    description: '500ml PET plastic bottle.',
    gtin: '00850012345688',
    is_recyclable: true,
    is_reusable: false,
    packaging_type: 'primary',
    recycled_content_percentage: 30,
    weight_grams: 28.5
  })
};

fetch('https://www.closient.com/sustainability/api/v1/packaging', 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/packaging",
  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([
    'description' => '500ml PET plastic bottle.',
    'gtin' => '00850012345688',
    'is_recyclable' => true,
    'is_reusable' => false,
    'packaging_type' => 'primary',
    'recycled_content_percentage' => 30,
    'weight_grams' => 28.5
  ]),
  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/packaging"

	payload := strings.NewReader("{\n  \"description\": \"500ml PET plastic bottle.\",\n  \"gtin\": \"00850012345688\",\n  \"is_recyclable\": true,\n  \"is_reusable\": false,\n  \"packaging_type\": \"primary\",\n  \"recycled_content_percentage\": 30,\n  \"weight_grams\": 28.5\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/packaging")
  .header("X-API-Key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"description\": \"500ml PET plastic bottle.\",\n  \"gtin\": \"00850012345688\",\n  \"is_recyclable\": true,\n  \"is_reusable\": false,\n  \"packaging_type\": \"primary\",\n  \"recycled_content_percentage\": 30,\n  \"weight_grams\": 28.5\n}")
  .asString();

require 'uri'
require 'net/http'

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

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  \"description\": \"500ml PET plastic bottle.\",\n  \"gtin\": \"00850012345688\",\n  \"is_recyclable\": true,\n  \"is_reusable\": false,\n  \"packaging_type\": \"primary\",\n  \"recycled_content_percentage\": 30,\n  \"weight_grams\": 28.5\n}"

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

{
  "created": "2026-09-30T09:00:00Z",
  "description": "500ml PET plastic bottle.",
  "gtin": "00850012345688",
  "id": "F5n5NdW6dTbvPYkgnLNjte",
  "is_recyclable": true,
  "is_reusable": false,
  "modified": "2026-09-30T09:00:00Z",
  "organization_id": "9fHkqR2aXcVbNmLpQwErTy",
  "packaging_type": "primary",
  "recycled_content_percentage": 30,
  "weight_grams": 28.5
}

{
  "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

packaging

Create packaging element

curl --request POST \
  --url https://www.closient.com/sustainability/api/v1/packaging \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "description": "500ml PET plastic bottle.",
  "gtin": "00850012345688",
  "is_recyclable": true,
  "is_reusable": false,
  "packaging_type": "primary",
  "recycled_content_percentage": 30,
  "weight_grams": 28.5
}
'

import requests

url = "https://www.closient.com/sustainability/api/v1/packaging"

payload = {
    "description": "500ml PET plastic bottle.",
    "gtin": "00850012345688",
    "is_recyclable": True,
    "is_reusable": False,
    "packaging_type": "primary",
    "recycled_content_percentage": 30,
    "weight_grams": 28.5
}
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({
    description: '500ml PET plastic bottle.',
    gtin: '00850012345688',
    is_recyclable: true,
    is_reusable: false,
    packaging_type: 'primary',
    recycled_content_percentage: 30,
    weight_grams: 28.5
  })
};

fetch('https://www.closient.com/sustainability/api/v1/packaging', 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/packaging",
  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([
    'description' => '500ml PET plastic bottle.',
    'gtin' => '00850012345688',
    'is_recyclable' => true,
    'is_reusable' => false,
    'packaging_type' => 'primary',
    'recycled_content_percentage' => 30,
    'weight_grams' => 28.5
  ]),
  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/packaging"

	payload := strings.NewReader("{\n  \"description\": \"500ml PET plastic bottle.\",\n  \"gtin\": \"00850012345688\",\n  \"is_recyclable\": true,\n  \"is_reusable\": false,\n  \"packaging_type\": \"primary\",\n  \"recycled_content_percentage\": 30,\n  \"weight_grams\": 28.5\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/packaging")
  .header("X-API-Key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"description\": \"500ml PET plastic bottle.\",\n  \"gtin\": \"00850012345688\",\n  \"is_recyclable\": true,\n  \"is_reusable\": false,\n  \"packaging_type\": \"primary\",\n  \"recycled_content_percentage\": 30,\n  \"weight_grams\": 28.5\n}")
  .asString();

require 'uri'
require 'net/http'

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

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  \"description\": \"500ml PET plastic bottle.\",\n  \"gtin\": \"00850012345688\",\n  \"is_recyclable\": true,\n  \"is_reusable\": false,\n  \"packaging_type\": \"primary\",\n  \"recycled_content_percentage\": 30,\n  \"weight_grams\": 28.5\n}"

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

{
  "created": "2026-09-30T09:00:00Z",
  "description": "500ml PET plastic bottle.",
  "gtin": "00850012345688",
  "id": "F5n5NdW6dTbvPYkgnLNjte",
  "is_recyclable": true,
  "is_reusable": false,
  "modified": "2026-09-30T09:00:00Z",
  "organization_id": "9fHkqR2aXcVbNmLpQwErTy",
  "packaging_type": "primary",
  "recycled_content_percentage": 30,
  "weight_grams": 28.5
}

{
  "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 /packaging.

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

packaging_type

enum<string>

required

Packaging tier: primary (direct contact), secondary (retail wrap), tertiary (transport).

Available options:

primary,

secondary,

tertiary

description

string

default:""

Free-text description of the element.

Maximum string length: 200

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

weight_grams

number | null

Weight in grams, up to two decimal places.

Required range: 0 <= x <= 99999999.99

is_recyclable

boolean

default:false

Whether the element is generally recyclable.

is_reusable

boolean

default:false

Whether the element is designed for reuse.

recycled_content_percentage

number | null

Recycled content, 0-100.

Required range: 0 <= x <= 100

Response

Created

A packaging element 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).

packaging_type

string

required

Packaging tier: primary, secondary or tertiary.

description

string

required

Free-text description. Empty string when unset.

weight_grams

number | null

required

Weight in grams. Null when not measured.

is_recyclable

boolean

required

Whether the element is generally recyclable.

is_reusable

boolean

required

Whether the element is designed for reuse.

recycled_content_percentage

number | null

required

Recycled content, 0-100. Null when undeclared.

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 packaging element

Authorizations

Body

Response