add_recipient

Adds one address to the distribution list of the connected account, for all products or for the given ones, as "Abnehmer eintragen" does in the dashboard without "jetzt zustellen". No mail is sent; the first delivery is started in the dashboard. Refuses an address that is already on the list. Only add people who are customers of the account holder.

Argument	Type	Description
name	string	Contact person
email*	string	E-mail address of the recipient
company	string	Company
language	string	Language of the answer: "de" (German, default), "en" (English) or "pl" (Polish). Product and account answers are written in German and English; content without a translation comes in German.
product_ids	array	Only these products; default all products
mail_language	string	ISO 639-1 language of the delivery mails: de, en, fr, it, nl, pl, cs, sk, hu, sl, hr, ro, es, pt, da or sv. Default: the language of the manufacturer page

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "email"
  ],
  "properties": {
    "name": {
      "type": "string",
      "maxLength": 120,
      "description": "Contact person"
    },
    "email": {
      "type": "string",
      "maxLength": 200,
      "minLength": 3,
      "description": "E-mail address of the recipient"
    },
    "company": {
      "type": "string",
      "maxLength": 140,
      "description": "Company"
    },
    "language": {
      "enum": [
        "de",
        "en",
        "pl"
      ],
      "type": "string",
      "description": "Language of the answer: \"de\" (German, default), \"en\" (English) or \"pl\" (Polish). Product and account answers are written in German and English; content without a translation comes in German."
    },
    "product_ids": {
      "type": "array",
      "items": {
        "type": "integer",
        "maximum": 9007199254740991,
        "exclusiveMinimum": 0
      },
      "maxItems": 500,
      "description": "Only these products; default all products"
    },
    "mail_language": {
      "type": "string",
      "maxLength": 5,
      "description": "ISO 639-1 language of the delivery mails: de, en, fr, it, nl, pl, cs, sk, hu, sl, hr, ro, es, pt, da or sv. Default: the language of the manufacturer page"
    }
  }
}

check_battery_passport

Classifies a battery under Art. 3 of Regulation (EU) 2023/1542 (LMT, electric vehicle, SLI, portable, industrial) and says whether it needs a battery passport under Art. 77, with the provision. A planning aid, not an official classification.

read-only

Argument	Type	Description
use*	string	lv: light means of transport (e-bike, e-scooter); vehicle: traction battery of a vehicle of category M, N or O; sli: starter battery; other: anything else
sealed*	boolean	True if the battery is sealed
for_toy	boolean	True if the light means of transport is a toy
language	string	Language of the answer: "de" (German, default), "en" (English) or "pl" (Polish). Product and account answers are written in German and English; content without a translation comes in German.
weight_kg*	number	Weight in kilograms
industrial	boolean	True if it is designed specifically for industrial use
capacity_kwh	number	Capacity in kWh, needed for industrial batteries

check_duties

Runs ProofPass’s duties check (the same logic as the page /de/pflichten-check): from the role, the product types, the sales channels and the markets it returns the duties that already apply, those adopted with a later date and those expected, each with date, provision and legal sources, plus the link to the same result on the site. It knows the roles manufacturer, importer, distributor and online seller; for a downstream user it says so and derives nothing. Not legal advice.

read-only

Argument	Type	Description
role*	string	Role in the supply chain
markets	array	Markets: at (Austria), de (Germany), eu (other EU countries, default)
channels	array	Sales channels: b2b (default), own_shop, marketplace
language	string	Language of the answer: "de" (German, default), "en" (English) or "pl" (Polish). Product and account answers are written in German and English; content without a translation comes in German.
product_types*	array	What is sold: mixture (hazardous substance or mixture), construction_product, consumer_product, battery, machine, radio_equipment, detergent, textile, packaging

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "role",
    "product_types"
  ],
  "properties": {
    "role": {
      "enum": [
        "manufacturer",
        "importer",
        "distributor",
        "online_seller",
        "downstream_user"
      ],
      "type": "string",
      "description": "Role in the supply chain"
    },
    "markets": {
      "type": "array",
      "items": {
        "enum": [
          "at",
          "de",
          "eu"
        ],
        "type": "string"
      },
      "maxItems": 3,
      "description": "Markets: at (Austria), de (Germany), eu (other EU countries, default)"
    },
    "channels": {
      "type": "array",
      "items": {
        "enum": [
          "b2b",
          "own_shop",
          "marketplace"
        ],
        "type": "string"
      },
      "maxItems": 3,
      "description": "Sales channels: b2b (default), own_shop, marketplace"
    },
    "language": {
      "enum": [
        "de",
        "en",
        "pl"
      ],
      "type": "string",
      "description": "Language of the answer: \"de\" (German, default), \"en\" (English) or \"pl\" (Polish). Product and account answers are written in German and English; content without a translation comes in German."
    },
    "product_types": {
      "type": "array",
      "items": {
        "enum": [
          "mixture",
          "construction_product",
          "consumer_product",
          "battery",
          "machine",
          "radio_equipment",
          "detergent",
          "textile",
          "packaging"
        ],
        "type": "string"
      },
      "maxItems": 9,
      "minItems": 1,
      "description": "What is sold: mixture (hazardous substance or mixture), construction_product, consumer_product, battery, machine, radio_equipment, detergent, textile, packaging"
    }
  }
}

check_gpsr_information

Checks the information an online offer to consumers needs under Art. 19 GPSR (manufacturer, postal address, electronic address, product identifier, responsible person in the EU for manufacturers outside it) for formal completeness and returns it as a text block. Nothing is stored.

read-only

Argument	Type	Description
address*	string	Postal address
contact*	string	E-mail address
country	string	ISO country code of the manufacturer, e.g. "AT", "CN"
product	string	Product name
language	string	Language of the answer: "de" (German, default), "en" (English) or "pl" (Polish). Product and account answers are written in German and English; content without a translation comes in German.
warnings	string	Warnings and safety information
identifier	string	Type, batch or serial number
manufacturer*	string

check_identifier_codes

Checks the check digit of identifiers found on data sheets and labels: UFI, CAS number, EC number, GTIN/EAN. One code per line or separated by semicolons. It says whether a code is well formed, never whether it was issued or belongs to a product. Nothing is stored.

read-only

Argument	Type	Description
codes*	string	Codes, one per line, e.g. "CAS 64-17-5 N1Q0-30DW-K00N-4VKE 9006543210017"
language	string	Language of the answer: "de" (German, default), "en" (English) or "pl" (Polish). Product and account answers are written in German and English; content without a translation comes in German.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "codes"
  ],
  "properties": {
    "codes": {
      "type": "string",
      "maxLength": 4000,
      "minLength": 1,
      "description": "Codes, one per line, e.g. \"CAS 64-17-5\nN1Q0-30DW-K00N-4VKE\n9006543210017\""
    },
    "language": {
      "enum": [
        "de",
        "en",
        "pl"
      ],
      "type": "string",
      "description": "Language of the answer: \"de\" (German, default), \"en\" (English) or \"pl\" (Polish). Product and account answers are written in German and English; content without a translation comes in German."
    }
  }
}

check_sds_structure

Formal check of the text of a safety data sheet, the same as the page /de/sdb-check: which subsections of Annex II to REACH (format of Regulation (EU) 2020/878) are present, check digits of UFI and CAS numbers, hazard codes outside CLP, revision date and version. Pass the extracted text of the PDF. The text is checked in memory and not stored. It never says a sheet is correct in content.

read-only

Argument	Type	Description
text*	string	Text of the safety data sheet, all pages
language	string	Language of the answer: "de" (German, default), "en" (English) or "pl" (Polish). Product and account answers are written in German and English; content without a translation comes in German.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "text"
  ],
  "properties": {
    "text": {
      "type": "string",
      "maxLength": 400000,
      "minLength": 1,
      "description": "Text of the safety data sheet, all pages"
    },
    "language": {
      "enum": [
        "de",
        "en",
        "pl"
      ],
      "type": "string",
      "description": "Language of the answer: \"de\" (German, default), \"en\" (English) or \"pl\" (Polish). Product and account answers are written in German and English; content without a translation comes in German."
    }
  }
}

clp_label_dimensions

Returns the label size, pictogram size and minimum font size (x-height) for a pack size under section 1.2.1.4 of Annex I to the CLP Regulation as amended by Regulation (EU) 2024/2865, next to the value in the Omnibus text that is not yet law, with the date the values were last checked.

read-only

Argument	Type	Description
language	string	Language of the answer: "de" (German, default), "en" (English) or "pl" (Polish). Product and account answers are written in German and English; content without a translation comes in German.
volume_ml*	number	Capacity of the package in millilitres, e.g. 750

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "volume_ml"
  ],
  "properties": {
    "language": {
      "enum": [
        "de",
        "en",
        "pl"
      ],
      "type": "string",
      "description": "Language of the answer: \"de\" (German, default), \"en\" (English) or \"pl\" (Polish). Product and account answers are written in German and English; content without a translation comes in German."
    },
    "volume_ml": {
      "type": "number",
      "maximum": 100000000,
      "description": "Capacity of the package in millilitres, e.g. 750",
      "exclusiveMinimum": 0
    }
  }
}

create_product_draft

Creates a product in the connected account that is not shown publicly and holds no documents, as "Neues Produkt" with "Nicht öffentlich zeigen" does in the dashboard. Refuses with the reason when the account holds no more products. Returns the id, the QR link and the dashboard link where documents are uploaded and the product is made public.

Argument	Type	Description
ufi	string	UFI, e.g. N1Q0-30DW-K00N-4VKE
gtin	string	GTIN/EAN with 8, 12, 13 or 14 digits
name*	string	Product name as it should appear
keywords	string	Search words, comma separated: old names, colours, pack sizes
language	string	Language of the answer: "de" (German, default), "en" (English) or "pl" (Polish). Product and account answers are written in German and English; content without a translation comes in German.
description	string	Two or three sentences on what the product is for
article_number	string	Article number

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "name"
  ],
  "properties": {
    "ufi": {
      "type": "string",
      "maxLength": 19,
      "description": "UFI, e.g. N1Q0-30DW-K00N-4VKE"
    },
    "gtin": {
      "type": "string",
      "maxLength": 20,
      "description": "GTIN/EAN with 8, 12, 13 or 14 digits"
    },
    "name": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Product name as it should appear"
    },
    "keywords": {
      "type": "string",
      "maxLength": 500,
      "description": "Search words, comma separated: old names, colours, pack sizes"
    },
    "language": {
      "enum": [
        "de",
        "en",
        "pl"
      ],
      "type": "string",
      "description": "Language of the answer: \"de\" (German, default), \"en\" (English) or \"pl\" (Polish). Product and account answers are written in German and English; content without a translation comes in German."
    },
    "description": {
      "type": "string",
      "maxLength": 1000,
      "description": "Two or three sentences on what the product is for"
    },
    "article_number": {
      "type": "string",
      "maxLength": 60,
      "description": "Article number"
    }
  }
}

find_manufacturer

Finds checked manufacturers on ProofPass by name and returns the address of their public page and their slug (for list_manufacturer_documents and search_products). Only manufacturers that are checked, not paused and have at least one current document.

read-only

Argument	Type	Description
name*	string	Manufacturer or brand name, or part of it, e.g. "Muster"
limit	integer	At most this many results, 1 to 20. Default 10
language	string	Language of the answer: "de" (German, default), "en" (English) or "pl" (Polish). Product and account answers are written in German and English; content without a translation comes in German.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "maxLength": 100,
      "minLength": 2,
      "description": "Manufacturer or brand name, or part of it, e.g. \"Muster\""
    },
    "limit": {
      "type": "integer",
      "maximum": 20,
      "minimum": 1,
      "description": "At most this many results, 1 to 20. Default 10"
    },
    "language": {
      "enum": [
        "de",
        "en",
        "pl"
      ],
      "type": "string",
      "description": "Language of the answer: \"de\" (German, default), \"en\" (English) or \"pl\" (Polish). Product and account answers are written in German and English; content without a translation comes in German."
    }
  }
}

get_current_document

Returns the current published version of one document of a product: title, kind, language, version, revision date, publication date, product page, PDF URL on ProofPass and SHA-256, plus the other languages it exists in. Never an archived version. Kinds: sdb, tdb, dop, dopc, doc, ppwr, manual, epd, cert, other (also "SDS", "TDS", "DoP", "DoC"). / Liefert die aktuelle Fassung eines Dokuments (SDB, TDB, Leistungserklärung …) mit PDF-Link.

read-only

Argument	Type	Description
type*	string	Document kind: sdb, tdb, dop, dopc, doc, ppwr, manual, epd, cert, other; "SDS"/"SDB" for the safety data sheet
product*	string	Product id from search_products, QR short code, GTIN, "manufacturer-slug/product-slug" or the product page URL
language	string	Language of the answer: "de" (German, default), "en" (English) or "pl" (Polish). Product and account answers are written in German and English; content without a translation comes in German.
document_language	string	ISO 639-1 language of the document, any official EU language, e.g. "de", "en", "pl", "pt", "el". Default: the language of the answer, else the manufacturer’s

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "product",
    "type"
  ],
  "properties": {
    "type": {
      "type": "string",
      "maxLength": 60,
      "minLength": 2,
      "description": "Document kind: sdb, tdb, dop, dopc, doc, ppwr, manual, epd, cert, other; \"SDS\"/\"SDB\" for the safety data sheet"
    },
    "product": {
      "type": "string",
      "maxLength": 300,
      "minLength": 1,
      "description": "Product id from search_products, QR short code, GTIN, \"manufacturer-slug/product-slug\" or the product page URL"
    },
    "language": {
      "enum": [
        "de",
        "en",
        "pl"
      ],
      "type": "string",
      "description": "Language of the answer: \"de\" (German, default), \"en\" (English) or \"pl\" (Polish). Product and account answers are written in German and English; content without a translation comes in German."
    },
    "document_language": {
      "type": "string",
      "maxLength": 5,
      "description": "ISO 639-1 language of the document, any official EU language, e.g. \"de\", \"en\", \"pl\", \"pt\", \"el\". Default: the language of the answer, else the manufacturer’s"
    }
  }
}

get_glossary_term

Looks up one term in ProofPass’s glossary by name or abbreviation (e.g. "UFI", "SDB", "Leistungserklärung", "GPSR") and returns the definition, the explanation, its sources and related terms. The glossary is written in German.

read-only

Argument	Type	Description
term*	string	Term or abbreviation
language	string	Language of the answer: "de" (German, default), "en" (English) or "pl" (Polish). Product and account answers are written in German and English; content without a translation comes in German.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "term"
  ],
  "properties": {
    "term": {
      "type": "string",
      "maxLength": 80,
      "minLength": 2,
      "description": "Term or abbreviation"
    },
    "language": {
      "enum": [
        "de",
        "en",
        "pl"
      ],
      "type": "string",
      "description": "Language of the answer: \"de\" (German, default), \"en\" (English) or \"pl\" (Polish). Product and account answers are written in German and English; content without a translation comes in German."
    }
  }
}

get_my_product

Returns one product of the connected account: master data, every current document (kind, language, version, revision date, upload date, SHA-256), the version archive with the date each version was superseded, which safety data sheets are older than three years, how many recipients get new versions, the QR link and the dashboard link.

read-only

Argument	Type	Description
language	string	Language of the answer: "de" (German, default), "en" (English) or "pl" (Polish). Product and account answers are written in German and English; content without a translation comes in German.
product_id*	integer	Product id, as list_my_products returns it

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "product_id"
  ],
  "properties": {
    "language": {
      "enum": [
        "de",
        "en",
        "pl"
      ],
      "type": "string",
      "description": "Language of the answer: \"de\" (German, default), \"en\" (English) or \"pl\" (Polish). Product and account answers are written in German and English; content without a translation comes in German."
    },
    "product_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Product id, as list_my_products returns it",
      "exclusiveMinimum": 0
    }
  }
}

get_qr_link

Returns the permanent QR link of a product of the connected account (/q/<code>, it exists from the moment the product is created and never changes), the GS1 Digital Link if the product has a GTIN, the addresses of the QR image as PNG and SVG and the print sheet in the dashboard.

read-only

Argument	Type	Description
language	string	Language of the answer: "de" (German, default), "en" (English) or "pl" (Polish). Product and account answers are written in German and English; content without a translation comes in German.
product_id*	integer	Product id, as list_my_products returns it

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "product_id"
  ],
  "properties": {
    "language": {
      "enum": [
        "de",
        "en",
        "pl"
      ],
      "type": "string",
      "description": "Language of the answer: \"de\" (German, default), \"en\" (English) or \"pl\" (Polish). Product and account answers are written in German and English; content without a translation comes in German."
    },
    "product_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Product id, as list_my_products returns it",
      "exclusiveMinimum": 0
    }
  }
}

get_started

Returns the links to open a ProofPass account, to sign in, to the documentation and the tools without an account, and the first four steps. Use when someone wants to publish their own data sheets. Creates nothing.

read-only

Argument	Type	Description
language	string	Language of the answer: "de" (German, default), "en" (English) or "pl" (Polish). Product and account answers are written in German and English; content without a translation comes in German.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "language": {
      "enum": [
        "de",
        "en",
        "pl"
      ],
      "type": "string",
      "description": "Language of the answer: \"de\" (German, default), \"en\" (English) or \"pl\" (Polish). Product and account answers are written in German and English; content without a translation comes in German."
    }
  }
}

get_team_and_limits

Returns the logins of the connected account and how many products and logins it holds and uses, and whether the manufacturer page is checked and public.

read-only

Argument	Type	Description
language	string	Language of the answer: "de" (German, default), "en" (English) or "pl" (Polish). Product and account answers are written in German and English; content without a translation comes in German.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "language": {
      "enum": [
        "de",
        "en",
        "pl"
      ],
      "type": "string",
      "description": "Language of the answer: \"de\" (German, default), \"en\" (English) or \"pl\" (Polish). Product and account answers are written in German and English; content without a translation comes in German."
    }
  }
}

list_deadlines

Lists duties on product documents in the EU from ProofPass's deadline tracker: title, start date or the words for an open date, status (gilt = already applies, beschlossen = adopted with a later date, erwartet = expected, not yet adopted), what it requires and the legal sources. Filter by regulation (free words such as "REACH", "CLP", "GPSR", "PPWR", "2023/1542"), product group (chemie, bauchemie, bauprodukte, reiniger, batterien, metall, textil, moebel, reifen, elektro, maschinen, funk, spielzeug, verpackung), status or a date range. For a filter by role use check_duties. Every answer carries source, date of the last check and the note that it is not legal advice.

read-only

Argument	Type	Description
to	string	Only duties that start on or before this day, YYYY-MM-DD
from	string	Only duties that start on or after this day, YYYY-MM-DD
status	string	gilt, beschlossen or erwartet
language	string	Language of the answer: "de" (German, default), "en" (English) or "pl" (Polish). Product and account answers are written in German and English; content without a translation comes in German.
regulation	string	Regulation or topic in free words, e.g. "CLP", "battery", "2024/3110"
product_group	string	Product group id

list_delivery_proofs

Returns the proof of delivery of the connected account, newest first: which address was sent which document version when, whether sending failed, and when it was opened and downloaded. Optionally for one product.

read-only

Argument	Type	Description
limit	integer	Number of deliveries, default 50
language	string	Language of the answer: "de" (German, default), "en" (English) or "pl" (Polish). Product and account answers are written in German and English; content without a translation comes in German.
product_id	integer	Product id, as list_my_products returns it

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Number of deliveries, default 50"
    },
    "language": {
      "enum": [
        "de",
        "en",
        "pl"
      ],
      "type": "string",
      "description": "Language of the answer: \"de\" (German, default), \"en\" (English) or \"pl\" (Polish). Product and account answers are written in German and English; content without a translation comes in German."
    },
    "product_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Product id, as list_my_products returns it",
      "exclusiveMinimum": 0
    }
  }
}

list_documents_due

Lists the current documents of the connected account that are due for a look: safety data sheets whose revision date is older than three years (the reminder the dashboard shows) and documents without a revision date. ProofPass stores no expiry date for documents.

read-only

Argument	Type	Description
language	string	Language of the answer: "de" (German, default), "en" (English) or "pl" (Polish). Product and account answers are written in German and English; content without a translation comes in German.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "language": {
      "enum": [
        "de",
        "en",
        "pl"
      ],
      "type": "string",
      "description": "Language of the answer: \"de\" (German, default), \"en\" (English) or \"pl\" (Polish). Product and account answers are written in German and English; content without a translation comes in German."
    }
  }
}

list_manufacturer_documents

Lists the public products of one checked manufacturer with their current documents (kind, language, version, revision date, PDF URL), 25 per page. / Listet die Produkte eines Herstellers mit ihren aktuellen Dokumenten.

read-only

Argument	Type	Description
page	integer	Page, 25 products each. Default 1
language	string	Language of the answer: "de" (German, default), "en" (English) or "pl" (Polish). Product and account answers are written in German and English; content without a translation comes in German.
manufacturer*	string	Manufacturer slug, the part after /hersteller/ in the address

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "manufacturer"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 10000,
      "minimum": 1,
      "description": "Page, 25 products each. Default 1"
    },
    "language": {
      "enum": [
        "de",
        "en",
        "pl"
      ],
      "type": "string",
      "description": "Language of the answer: \"de\" (German, default), \"en\" (English) or \"pl\" (Polish). Product and account answers are written in German and English; content without a translation comes in German."
    },
    "manufacturer": {
      "type": "string",
      "maxLength": 100,
      "minLength": 1,
      "description": "Manufacturer slug, the part after /hersteller/ in the address"
    }
  }
}

list_my_products

Lists the products of the connected ProofPass account (also those not public) with id, article number, GTIN, whether they are public and how many current documents they hold; optionally only those matching a search word. Use first to find a product id.

read-only

Argument	Type	Description
limit	integer	Number of products, default 20
query	string	Part of the name, article number, GTIN or UFI
language	string	Language of the answer: "de" (German, default), "en" (English) or "pl" (Polish). Product and account answers are written in German and English; content without a translation comes in German.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 50,
      "minimum": 1,
      "description": "Number of products, default 20"
    },
    "query": {
      "type": "string",
      "maxLength": 120,
      "description": "Part of the name, article number, GTIN or UFI"
    },
    "language": {
      "enum": [
        "de",
        "en",
        "pl"
      ],
      "type": "string",
      "description": "Language of the answer: \"de\" (German, default), \"en\" (English) or \"pl\" (Polish). Product and account answers are written in German and English; content without a translation comes in German."
    }
  }
}

list_open_duties

Returns the open items the dashboard overview shows for the connected account (products without a document, old safety data sheets, failed deliveries, open requests and the like), each with the place in the dashboard where it is fixed. Labels are in German.

read-only

Argument	Type	Description
language	string	Language of the answer: "de" (German, default), "en" (English) or "pl" (Polish). Product and account answers are written in German and English; content without a translation comes in German.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "language": {
      "enum": [
        "de",
        "en",
        "pl"
      ],
      "type": "string",
      "description": "Language of the answer: \"de\" (German, default), \"en\" (English) or \"pl\" (Polish). Product and account answers are written in German and English; content without a translation comes in German."
    }
  }
}

list_recalls

Lists the recalls and safety warnings of the connected account with kind, product, status, hazard, the instruction to stop using, what customers should do, the remedies offered (repair, replacement, refund), contact, dates and closing note. Creating, publishing, notifying recipients and closing a recall is done in the dashboard only.

read-only

Argument	Type	Description
language	string	Language of the answer: "de" (German, default), "en" (English) or "pl" (Polish). Product and account answers are written in German and English; content without a translation comes in German.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "language": {
      "enum": [
        "de",
        "en",
        "pl"
      ],
      "type": "string",
      "description": "Language of the answer: \"de\" (German, default), \"en\" (English) or \"pl\" (Polish). Product and account answers are written in German and English; content without a translation comes in German."
    }
  }
}

list_recipients

Lists the distribution list of the connected account: address, company, confirmed or unsubscribed, and whether a recipient gets all products or only some.

read-only

Argument	Type	Description
limit	integer	Number of recipients, default 50
query	string	Part of the address, company or name
language	string	Language of the answer: "de" (German, default), "en" (English) or "pl" (Polish). Product and account answers are written in German and English; content without a translation comes in German.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Number of recipients, default 50"
    },
    "query": {
      "type": "string",
      "maxLength": 120,
      "description": "Part of the address, company or name"
    },
    "language": {
      "enum": [
        "de",
        "en",
        "pl"
      ],
      "type": "string",
      "description": "Language of the answer: \"de\" (German, default), \"en\" (English) or \"pl\" (Polish). Product and account answers are written in German and English; content without a translation comes in German."
    }
  }
}

preview_distribution

Shows who would receive the current documents of a product of the connected account: the confirmed recipients on its distribution list and the documents. It sends nothing and records nothing; sending is done with a button in the dashboard, and the tool returns that link.

read-only

Argument	Type	Description
language	string	Language of the answer: "de" (German, default), "en" (English) or "pl" (Polish). Product and account answers are written in German and English; content without a translation comes in German.
product_id*	integer	Product id, as list_my_products returns it

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "product_id"
  ],
  "properties": {
    "language": {
      "enum": [
        "de",
        "en",
        "pl"
      ],
      "type": "string",
      "description": "Language of the answer: \"de\" (German, default), \"en\" (English) or \"pl\" (Polish). Product and account answers are written in German and English; content without a translation comes in German."
    },
    "product_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Product id, as list_my_products returns it",
      "exclusiveMinimum": 0
    }
  }
}

resolve_product

Resolves what is printed on a label or pasted from a browser to the public product: a ProofPass QR link or its 7-character code (/q/<code>), a GTIN or GS1 Digital Link (/01/<gtin>), a product page address or "manufacturer-slug/product-slug". Returns the identifiers and every current document exactly as the public product page shows them; hidden products, unchecked or paused manufacturers and archived versions are never returned.

read-only

Argument	Type	Description
product*	string	QR link or code, GTIN, GS1 Digital Link, product page URL, "manufacturer-slug/product-slug" or a product id from search_products
language	string	Language of the answer: "de" (German, default), "en" (English) or "pl" (Polish). Product and account answers are written in German and English; content without a translation comes in German.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "product"
  ],
  "properties": {
    "product": {
      "type": "string",
      "maxLength": 300,
      "minLength": 1,
      "description": "QR link or code, GTIN, GS1 Digital Link, product page URL, \"manufacturer-slug/product-slug\" or a product id from search_products"
    },
    "language": {
      "enum": [
        "de",
        "en",
        "pl"
      ],
      "type": "string",
      "description": "Language of the answer: \"de\" (German, default), \"en\" (English) or \"pl\" (Polish). Product and account answers are written in German and English; content without a translation comes in German."
    }
  }
}

search_knowledge

Searches ProofPass’s published guides, questions and glossary (German, English, Polish) and returns title, the short answer, the provision it rests on, the date of the last check and the link. Use for questions on safety data sheets, CLP and UFI, GPSR, construction products, battery and product passport, packaging. When a language has no match, the German library answers and says so.

read-only

Argument	Type	Description
limit	integer	Number of results, default 5
query*	string	Search words, e.g. "Sicherheitsdatenblatt Sprache" or "battery passport"
language	string	Language of the answer: "de" (German, default), "en" (English) or "pl" (Polish). Product and account answers are written in German and English; content without a translation comes in German.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "query"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 10,
      "minimum": 1,
      "description": "Number of results, default 5"
    },
    "query": {
      "type": "string",
      "maxLength": 200,
      "minLength": 2,
      "description": "Search words, e.g. \"Sicherheitsdatenblatt Sprache\" or \"battery passport\""
    },
    "language": {
      "enum": [
        "de",
        "en",
        "pl"
      ],
      "type": "string",
      "description": "Language of the answer: \"de\" (German, default), \"en\" (English) or \"pl\" (Polish). Product and account answers are written in German and English; content without a translation comes in German."
    }
  }
}

search_products

Searches the public products of checked manufacturers on ProofPass by name, article number, GTIN/EAN or UFI, optionally within one manufacturer. Returns up to 20 products with manufacturer, identifiers, available document kinds and the product page URL. / Sucht öffentliche Produkte geprüfter Hersteller nach Name, Artikelnummer, GTIN oder UFI.

read-only

Argument	Type	Description
limit	integer	At most this many results, 1 to 20. Default 10
query*	string	Product name, article number, GTIN/EAN or UFI, e.g. "Silikon Neutral" or "9006543210017"
language	string	Language of the answer: "de" (German, default), "en" (English) or "pl" (Polish). Product and account answers are written in German and English; content without a translation comes in German.
manufacturer	string	Manufacturer slug to search within (the part after /hersteller/ in the address)

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "query"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 20,
      "minimum": 1,
      "description": "At most this many results, 1 to 20. Default 10"
    },
    "query": {
      "type": "string",
      "maxLength": 120,
      "minLength": 1,
      "description": "Product name, article number, GTIN/EAN or UFI, e.g. \"Silikon Neutral\" or \"9006543210017\""
    },
    "language": {
      "enum": [
        "de",
        "en",
        "pl"
      ],
      "type": "string",
      "description": "Language of the answer: \"de\" (German, default), \"en\" (English) or \"pl\" (Polish). Product and account answers are written in German and English; content without a translation comes in German."
    },
    "manufacturer": {
      "type": "string",
      "maxLength": 100,
      "description": "Manufacturer slug to search within (the part after /hersteller/ in the address)"
    }
  }
}

update_product

Changes master data of a product of the connected account: name, article number, GTIN, UFI, description, search words. Only the fields given change; an empty string clears a field. On a public product the change is visible at once, as after "Speichern" in the dashboard, and the previous values are not kept. Visibility, category, documents and deletion stay in the dashboard.

destructive

Argument	Type	Description
ufi	string	UFI, e.g. N1Q0-30DW-K00N-4VKE
gtin	string	GTIN/EAN with 8, 12, 13 or 14 digits
name	string	New product name
keywords	string	Search words, comma separated: old names, colours, pack sizes
language	string	Language of the answer: "de" (German, default), "en" (English) or "pl" (Polish). Product and account answers are written in German and English; content without a translation comes in German.
product_id*	integer	Product id, as list_my_products returns it
description	string	Two or three sentences on what the product is for
article_number

verify_document

Tells whether a PDF is a document a checked manufacturer published on ProofPass, and whether it is still the current version. Give its SHA-256 checksum (64 hex digits) or its ProofPass PDF URL (/pdf/…). For a superseded version it returns the current one. / Prüft, ob eine PDF veröffentlicht und noch die aktuelle Fassung ist.

read-only

Argument	Type	Description
document*	string	SHA-256 of the file (64 hex digits) or its PDF URL on ProofPass
language	string	Language of the answer: "de" (German, default), "en" (English) or "pl" (Polish). Product and account answers are written in German and English; content without a translation comes in German.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "document"
  ],
  "properties": {
    "document": {
      "type": "string",
      "maxLength": 500,
      "minLength": 1,
      "description": "SHA-256 of the file (64 hex digits) or its PDF URL on ProofPass"
    },
    "language": {
      "enum": [
        "de",
        "en",
        "pl"
      ],
      "type": "string",
      "description": "Language of the answer: \"de\" (German, default), \"en\" (English) or \"pl\" (Polish). Product and account answers are written in German and English; content without a translation comes in German."
    }
  }
}

ProofPass

Registry entry

Try it

add_recipient

ProofPass

Registry entry

Try it

add_recipient

Install

Tools (29)

Security checkA100/100