Govseer

Developers

Govseer API

Send a safety data sheet, get back what an online listing must show under the EU CLP Regulation (Article 48a, from 1 January 2028): pictograms, signal word, hazard and precautionary statements in their official wording, the "Contains" line and what the sheet leaves open. Any of the 24 EU languages.

Get a key

Sign in and create an API key under API keys. A key acts for your account and uses its monthly checks (Free: 10 a month). It is shown once; keep it secret, and revoke it on your account page if it may have leaked.

Check a sheet

curl -X POST "https://govseer-api-823928849037.europe-west1.run.app/api/v1/check?lang=DE" \
  -H "Authorization: Bearer gsk_live_…" \
  -H "Content-Type: application/pdf" \
  --data-binary @safety-data-sheet.pdf
PartMeaning
langLanguage of the label: BG CS DA DE EL EN ES ET FI FR GA HR HU IT LT LV MT NL PL PT RO SK SL SV. The sheet itself may be in any of them.
ui (optional)Language of the findings: EN DE FR NL IT ES PL. Default EN.
BodyThe safety data sheet as a PDF, up to 10 MB. It is read once and not stored.

A check takes 10 to 60 seconds; allow a timeout of at least 90.

Answer

{
  "language": "DE",
  "sheetLanguage": "EN",
  "productName": "Example Citrus Surface Cleaner",
  "signalWord": { "code": "Danger", "text": "Gefahr" },
  "pictograms": ["GHS05", "GHS07"],
  "contains": { "names": ["sodium lauryl sulphate", "citral"], "text": "Enthält sodium lauryl sulphate, citral." },
  "hazards": [{ "code": "H318", "text": "Verursacht schwere Augenschäden." }],
  "precautions": [{ "code": "P501", "text": "Inhalt/Behälter … zuführen.", "openBlank": true }],
  "ufi": null,
  "findings": [{ "severity": "warning", "message": "…", "reference": "…" }],
  "uncertainties": [],
  "statementsVersion": "02008R1272 — EN — 01.01.2027 — 032.001",
  "usage": { "month": "2026-11", "checks": 3, "limit": 10 }
}

Several languages in one check

Shops that sell in several languages can ask for all of them at once with langs instead of lang. The sheet is read once and counts as one check.

curl -X POST "https://govseer-api-823928849037.europe-west1.run.app/api/v1/check?langs=DE,FR,NL" \
  -H "Authorization: Bearer gsk_live_…" \
  -H "Content-Type: application/pdf" \
  --data-binary @safety-data-sheet.pdf

The answer has extraction (what the sheet says: signal word, pictograms, codes, substances named, UFI, the supplier's own words for blanks, the sheet's language), labels (the answer above, one per language, keyed DE, FR, …), statementsVersion and usage.

Wording for confirmed codes

Once a person has compared the label elements with the sheet and confirmed them, ask for the official wording without reading the sheet again. This is not counted. Call it again when statementsVersion changes, so labels keep up with the official texts.

curl -X POST "https://govseer-api-823928849037.europe-west1.run.app/api/v1/render" \
  -H "Authorization: Bearer gsk_live_…" \
  -H "Content-Type: application/json" \
  -d '{"label": {"signalWord": "Danger", "pictograms": ["GHS05"],
        "hazardStatements": ["H318"], "precautionaryStatements": ["P280", "P501"],
        "contains": ["citral"], "substance": false, "ufi": "N1QV-R02N-F00K-1HMT"},
       "langs": ["DE", "FR"], "ui": "EN", "product": "shop.example.com:123"}'

The answer has labels (one per language, as above) and statementsVersion. Codes, pictograms (GHS01–GHS09) and languages are checked strictly; anything malformed returns 400 label.

product is your own id for the product (letters, digits and . : @ / _ -, up to 200 characters). Each product counts against your plan's products with a label (Free 5, Starter 50, Growth 500, Pro unlimited) from its first request; a product already counted is always answered. When a product's label is removed or the product deleted, free its place:

curl -X POST "https://govseer-api-823928849037.europe-west1.run.app/api/v1/products/release" \
  -H "Authorization: Bearer gsk_live_…" -H "Content-Type: application/json" \
  -d '{"product": "shop.example.com:123"}'

A product with no request for 60 days stops counting by itself.

Marketplace fields

The hazard fields bol.com, eBay and Amazon EU ask sellers for, filled from one sheet. Counts as one check.

curl -X POST "https://govseer-api-823928849037.europe-west1.run.app/api/v1/marketplace-fields?langs=NL,DE&name=Citrus%20Cleaner&quantity=500%20ml" \
  -H "Authorization: Bearer gsk_live_…" \
  -H "Content-Type: application/pdf" \
  --data-binary @safety-data-sheet.pdf
PartMeaning
langs (optional)The languages you sell in; each marketplace answers in those it uses (bol.com always in NL and FR). Default EN.
name, quantity (optional)The product's name and nominal quantity, for the fields that ask for them. Without a name, the sheet's product name is used.

The answer is the multi-language answer above plus markets: for bol, ebay and amazon, one entry per language with its fields (key, label, value) and notes on what is missing or limited (each with a key and English text).

CAS and EC numbers and ingredients come from section 3 of the sheet as printed; nothing is looked up.

Errors

StatuserrorMeaning
400language, not_pdf, labelUnknown lang or langs, the body is not a PDF, or malformed label elements.
401api_keyMissing, wrong or revoked key.
403product_limitAll of your plan's products with a label are in use; products says how many. Release one or choose a bigger plan.
413too_largeLarger than 10 MB.
429monthly_limit, daily_limit, rate_limitThis month's checks are used up (usage says how many; they renew on the 1st, UTC), free checks are busy for today, or too many requests in the last hour.
502read_failedThe sheet could not be read. Not counted against your checks; try again or check the file.

The result is a tool, not legal advice. The supplier of a product is responsible for its label.