Create substance of concern

curl --request POST \
  --url https://www.closient.com/sustainability/api/v1/substances-of-concern \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "concentration": 0.1,
  "concentration_unit": "PPM",
  "gtin": "00850012345688",
  "is_above_threshold": false,
  "notes": "Measured on the solder joints.",
  "regulation": "PROP65",
  "substance_id": "8Jw2nQxK5vTbR3mYcLdZaE",
  "threshold_unit": "PPM",
  "threshold_value": 0.5
}
'

import requests

url = "https://www.closient.com/sustainability/api/v1/substances-of-concern"

payload = {
    "concentration": 0.1,
    "concentration_unit": "PPM",
    "gtin": "00850012345688",
    "is_above_threshold": False,
    "notes": "Measured on the solder joints.",
    "regulation": "PROP65",
    "substance_id": "8Jw2nQxK5vTbR3mYcLdZaE",
    "threshold_unit": "PPM",
    "threshold_value": 0.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({
    concentration: 0.1,
    concentration_unit: 'PPM',
    gtin: '00850012345688',
    is_above_threshold: false,
    notes: 'Measured on the solder joints.',
    regulation: 'PROP65',
    substance_id: '8Jw2nQxK5vTbR3mYcLdZaE',
    threshold_unit: 'PPM',
    threshold_value: 0.5
  })
};

fetch('https://www.closient.com/sustainability/api/v1/substances-of-concern', 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/substances-of-concern",
  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([
    'concentration' => 0.1,
    'concentration_unit' => 'PPM',
    'gtin' => '00850012345688',
    'is_above_threshold' => false,
    'notes' => 'Measured on the solder joints.',
    'regulation' => 'PROP65',
    'substance_id' => '8Jw2nQxK5vTbR3mYcLdZaE',
    'threshold_unit' => 'PPM',
    'threshold_value' => 0.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/substances-of-concern"

	payload := strings.NewReader("{\n  \"concentration\": 0.1,\n  \"concentration_unit\": \"PPM\",\n  \"gtin\": \"00850012345688\",\n  \"is_above_threshold\": false,\n  \"notes\": \"Measured on the solder joints.\",\n  \"regulation\": \"PROP65\",\n  \"substance_id\": \"8Jw2nQxK5vTbR3mYcLdZaE\",\n  \"threshold_unit\": \"PPM\",\n  \"threshold_value\": 0.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/substances-of-concern")
  .header("X-API-Key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"concentration\": 0.1,\n  \"concentration_unit\": \"PPM\",\n  \"gtin\": \"00850012345688\",\n  \"is_above_threshold\": false,\n  \"notes\": \"Measured on the solder joints.\",\n  \"regulation\": \"PROP65\",\n  \"substance_id\": \"8Jw2nQxK5vTbR3mYcLdZaE\",\n  \"threshold_unit\": \"PPM\",\n  \"threshold_value\": 0.5\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://www.closient.com/sustainability/api/v1/substances-of-concern")

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  \"concentration\": 0.1,\n  \"concentration_unit\": \"PPM\",\n  \"gtin\": \"00850012345688\",\n  \"is_above_threshold\": false,\n  \"notes\": \"Measured on the solder joints.\",\n  \"regulation\": \"PROP65\",\n  \"substance_id\": \"8Jw2nQxK5vTbR3mYcLdZaE\",\n  \"threshold_unit\": \"PPM\",\n  \"threshold_value\": 0.5\n}"

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

{
  "concentration": 0.1,
  "concentration_unit": "PPM",
  "created": "2026-09-30T09:00:00Z",
  "gtin": "00850012345688",
  "id": "F5n5NdW6dTbvPYkgnLNjte",
  "is_above_threshold": false,
  "modified": "2026-09-30T09:00:00Z",
  "notes": "Measured on the solder joints.",
  "organization_id": "9fHkqR2aXcVbNmLpQwErTy",
  "regulation": "PROP65",
  "substance_id": "8Jw2nQxK5vTbR3mYcLdZaE",
  "substance_name": "Lead",
  "threshold_unit": "PPM",
  "threshold_value": 0.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

substances-of-concern

Create substance of concern

curl --request POST \
  --url https://www.closient.com/sustainability/api/v1/substances-of-concern \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "concentration": 0.1,
  "concentration_unit": "PPM",
  "gtin": "00850012345688",
  "is_above_threshold": false,
  "notes": "Measured on the solder joints.",
  "regulation": "PROP65",
  "substance_id": "8Jw2nQxK5vTbR3mYcLdZaE",
  "threshold_unit": "PPM",
  "threshold_value": 0.5
}
'

import requests

url = "https://www.closient.com/sustainability/api/v1/substances-of-concern"

payload = {
    "concentration": 0.1,
    "concentration_unit": "PPM",
    "gtin": "00850012345688",
    "is_above_threshold": False,
    "notes": "Measured on the solder joints.",
    "regulation": "PROP65",
    "substance_id": "8Jw2nQxK5vTbR3mYcLdZaE",
    "threshold_unit": "PPM",
    "threshold_value": 0.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({
    concentration: 0.1,
    concentration_unit: 'PPM',
    gtin: '00850012345688',
    is_above_threshold: false,
    notes: 'Measured on the solder joints.',
    regulation: 'PROP65',
    substance_id: '8Jw2nQxK5vTbR3mYcLdZaE',
    threshold_unit: 'PPM',
    threshold_value: 0.5
  })
};

fetch('https://www.closient.com/sustainability/api/v1/substances-of-concern', 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/substances-of-concern",
  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([
    'concentration' => 0.1,
    'concentration_unit' => 'PPM',
    'gtin' => '00850012345688',
    'is_above_threshold' => false,
    'notes' => 'Measured on the solder joints.',
    'regulation' => 'PROP65',
    'substance_id' => '8Jw2nQxK5vTbR3mYcLdZaE',
    'threshold_unit' => 'PPM',
    'threshold_value' => 0.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/substances-of-concern"

	payload := strings.NewReader("{\n  \"concentration\": 0.1,\n  \"concentration_unit\": \"PPM\",\n  \"gtin\": \"00850012345688\",\n  \"is_above_threshold\": false,\n  \"notes\": \"Measured on the solder joints.\",\n  \"regulation\": \"PROP65\",\n  \"substance_id\": \"8Jw2nQxK5vTbR3mYcLdZaE\",\n  \"threshold_unit\": \"PPM\",\n  \"threshold_value\": 0.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/substances-of-concern")
  .header("X-API-Key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"concentration\": 0.1,\n  \"concentration_unit\": \"PPM\",\n  \"gtin\": \"00850012345688\",\n  \"is_above_threshold\": false,\n  \"notes\": \"Measured on the solder joints.\",\n  \"regulation\": \"PROP65\",\n  \"substance_id\": \"8Jw2nQxK5vTbR3mYcLdZaE\",\n  \"threshold_unit\": \"PPM\",\n  \"threshold_value\": 0.5\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://www.closient.com/sustainability/api/v1/substances-of-concern")

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  \"concentration\": 0.1,\n  \"concentration_unit\": \"PPM\",\n  \"gtin\": \"00850012345688\",\n  \"is_above_threshold\": false,\n  \"notes\": \"Measured on the solder joints.\",\n  \"regulation\": \"PROP65\",\n  \"substance_id\": \"8Jw2nQxK5vTbR3mYcLdZaE\",\n  \"threshold_unit\": \"PPM\",\n  \"threshold_value\": 0.5\n}"

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

{
  "concentration": 0.1,
  "concentration_unit": "PPM",
  "created": "2026-09-30T09:00:00Z",
  "gtin": "00850012345688",
  "id": "F5n5NdW6dTbvPYkgnLNjte",
  "is_above_threshold": false,
  "modified": "2026-09-30T09:00:00Z",
  "notes": "Measured on the solder joints.",
  "organization_id": "9fHkqR2aXcVbNmLpQwErTy",
  "regulation": "PROP65",
  "substance_id": "8Jw2nQxK5vTbR3mYcLdZaE",
  "substance_name": "Lead",
  "threshold_unit": "PPM",
  "threshold_value": 0.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 /substances-of-concern.

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

substance_id

string<shortuuid>

required

A substance from the substance catalog, else 404. Substances still awaiting review are not accepted. 409 if the product already records this substance for the same component.

Required string length: 22

Pattern: ^[23456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22}$

component_id

string<shortuuid> | null

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}$

concentration

number | null

Measured concentration, 0-1,000,000.

Required range: 0 <= x <= 1000000

concentration_unit

enum<string> | null

Unit of concentration.

Available options:

PPM,

PPB,

MG_KG,

MG_L,

UG_KG,

UG_L,

PERCENT

threshold_value

number | null

Regulatory or internal limit, 0-1,000,000.

Required range: 0 <= x <= 1000000

threshold_unit

enum<string> | null

Unit of threshold_value. Use the same unit as concentration_unit.

Available options:

PPM,

PPB,

MG_KG,

MG_L,

UG_KG,

UG_L,

PERCENT

regulation

enum<string>

default:OTHER

Regulation the substance is tracked under.

Available options:

REACH,

ROHS,

PROP65,

TSCA,

FDA,

OTHER

is_above_threshold

boolean

default:false

Whether the concentration is above the threshold.

notes

string

default:""

Free-text notes.

Maximum string length: 1000

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

Response

Created

A regulated substance present in one of the organization's products.

string<shortuuid>

required

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).

substance_id

string<shortuuid>

required

The substance, from the substance catalog.

Required string length: 22

Pattern: ^[23456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22}$

substance_name

string

required

The substance's name.

component_id

string<shortuuid> | null

required

Required string length: 22

Pattern: ^[23456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22}$

concentration

number | null

required

Measured concentration. Null when unmeasured.

concentration_unit

string

required

Unit of concentration. Empty when unset.

threshold_value

number | null

required

Regulatory or internal limit. Null when unset.

threshold_unit

string

required

Unit of threshold_value. Empty when unset.

regulation

string

required

Regulation the substance is tracked under.

is_above_threshold

boolean

required

Whether the concentration is above the threshold.

notes

string

required

Free-text notes. 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 substance of concern

Authorizations

Body

Response