Endpoint
GET https://certmap.eu/api/search
Every call requires an x-api-key header. Register with your email - your account is created with a personal key you'll find on your dashboard.
Parameters
Every result carries a scheme field (iscc or better-biomass) so you can distinguish the source. Single-cert lookups by ID (e.g. your own tick job) automatically detect the scheme from the prefix.
Examples
Search across both schemes (default):
curl -H "x-api-key: YOUR_KEY" \ "https://certmap.eu/api/search?query=cargill&filter_status=valid"
Better Biomass only:
curl -H "x-api-key: YOUR_KEY" \ "https://certmap.eu/api/search?query=biofuel&scheme=better-biomass"
ISCC only, with status filter:
curl -H "x-api-key: YOUR_KEY" \ "https://certmap.eu/api/search?query=nl220&scheme=iscc&filter_status=valid,suspended"
Response
JSON array of certificate objects. Dates in ISO 8601 (YYYY-MM-DD). Both schemes share the same fields; ISCC-specific fields (scope, raw_material, processing_unit_type) are arrays and are empty or omitted for Better Biomass. Better Biomass returns country alongside certificate_holder and the audit PDF.
ISCC result:
{
"scheme": "iscc",
"certificate_id": "EU-ISCC-Cert-PL219-83314809",
"certificate_holder": "Cargill Poland Sp.z.o.o., ...",
"valid_from": "2026-07-12",
"valid_until": "2027-07-11",
"status": "valid",
"status_date": null,
"scope": ["Trader with Storage", "Processing Unit"],
"raw_material": ["Rapeseed / canola"],
"products": "Bioethanol",
"issuing_cb": "SGS Germany GmbH, Emstek, DE",
"certificate_pdf_url": "https://hub.iscc-system.org/...",
"audit_report_url": "https://hub.iscc-system.org/...",
"map_url": "https://www.google.com/maps/..."
}
Better Biomass result:
{
"scheme": "better-biomass",
"certificate_id": "QSC-1234",
"certificate_holder": "Example Biofuel B.V.",
"country": "NL",
"valid_from": "2026-01-15",
"valid_until": "2027-01-14",
"status": "valid",
"products": "Biogas, Bioethanol",
"issuing_cb": "SGS Nederland B.V.",
"audit_report_url": "https://nen.bettywebblocks.com/..."
}
status values: valid, suspended, withdrawn, historical (expired).
Request an API key
Register at certmap.eu/en/login.html - your account and personal API key are created instantly. You'll find the key and daily call count on your dashboard.
For commercial use, higher volume, or partnerships: api@certmap.eu.