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
| Part | Meaning |
|---|---|
lang | Language 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. |
| Body | The 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 }
}
- Wording comes only from the official texts of the Regulation; the AI only reads which codes and names the sheet lists.
openBlank: true: the official wording has a blank (shown as …) that the supplier fills in, such as a disposal route.findings: problems in the sheet's label elements, with the legal reference.uncertainties: what the reader was unsure about.- Your own business name, EU address and telephone number, and the nominal quantity for consumer sales, come from you, not from the sheet.
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
| Part | Meaning |
|---|---|
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).
- bol.com: chemical name, EC or CAS number, ingredient list, content, P, H and EUH phrases with their official wording, UFI and label language; bol.com makes the signal word and icons itself.
- eBay: signal word in the site's language, up to 4 pictograms and up to 8 hazard statements (EUH codes written
EUH 208), as eBay's hazardous materials fields take them, and the component. - Amazon EU: the signal word, pictograms and hazard and precautionary statements its product pages show. Amazon's own field names are not mapped yet.
CAS and EC numbers and ingredients come from section 3 of the sheet as printed; nothing is looked up.
Errors
| Status | error | Meaning |
|---|---|---|
| 400 | language, not_pdf, label | Unknown lang or langs, the body is not a PDF, or malformed label elements. |
| 401 | api_key | Missing, wrong or revoked key. |
| 403 | product_limit | All of your plan's products with a label are in use; products says how many. Release one or choose a bigger plan. |
| 413 | too_large | Larger than 10 MB. |
| 429 | monthly_limit, daily_limit, rate_limit | This 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. |
| 502 | read_failed | The 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.