Skip to content

Reference Data Api (2.0)

Download OpenAPI description
OpenAPISpecification.json
OpenAPISpecification.yaml
Languages
Servers
Production
https://apis.traceone.com/reference-data/
Sandbox
https://apis-ppd.traceone.com/reference-data/

Reference Lists

Operations

Allergens

Operations

Countries

Operations

Country Divisions

Operations

Fishing Zones

Operations

Harmonized Codes

Operations

Markets

Operations

Nutrient Families

Operations

Nutrients

Operations

Raw Material Classification

Operations

Raw Material Parts

Operations

Substance Functions

Operations

Substances

Operations

Get by id

Request

Get substance details

Security
Bearer
Path
substanceIdstring(uuid)required

Substance identifier

Query
languageCodestring

Language code (optional, default: en-US)

Example: languageCode=fr-FR
companyIdstring(uuid)

Company Identifier (optional, allows getting company-specific substance names)

curl -i -X GET \
  'https://apis.traceone.com/reference-data/v2/substances/{substanceId}?languageCode=fr-FR&companyId=497f6eca-6276-4993-bfeb-53cbbbba6f08' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

Substance

Body
idstring(uuid)

Substance identifier

namestring

Substance name

eNumberstring or null

E number

descriptionstring or null

Substance description

iupacNamestring or null

IUPAC name

inciNamestring or null

INCI name

molecularFormulastring or null

Molecular formula

casNumbersArray of strings or null

Substance CAS numbers

ceNumbersArray of strings or null

Substance CE numbers

colorIndexesArray of strings or null

Substance Color indexes

synonymsArray of strings or null

Substance synonyms

usagesArray of objects or null(SubstanceUsage)

Substance usages

Response
No response example