Endpoint
GET https://certmap.eu/api/search
Alle calls vereisen een x-api-key header. Registreer met je emailadres - je account wordt aangemaakt met een eigen key die je op je dashboard vindt.
Parameters
Elk resultaat bevat een scheme-veld (iscc of better-biomass) zodat je de bron kunt onderscheiden. Cert-lookups per ID (bijv. via je eigen tick-job) detecteren automatisch het juiste schema aan de prefix.
Voorbeelden
Zoeken over beide schema's (default):
curl -H "x-api-key: YOUR_KEY" \ "https://certmap.eu/api/search?query=cargill&filter_status=valid"
Alleen Better Biomass:
curl -H "x-api-key: YOUR_KEY" \ "https://certmap.eu/api/search?query=biofuel&scheme=better-biomass"
Alleen ISCC, met 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 met certificaat-objecten. Datums in ISO 8601 (YYYY-MM-DD). Beide schema's leveren dezelfde velden; ISCC-specifieke velden (scope, raw_material, processing_unit_type) zijn arrays en zijn leeg of ontbreken bij Better Biomass. Better Biomass geeft naast country ook certificate_holder en de audit-PDF terug.
ISCC-resultaat:
{
"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-resultaat:
{
"scheme": "better-biomass",
"certificate_id": "QSC-1234",
"certificate_holder": "Voorbeeld Biobrandstof 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-waardes: valid, suspended, withdrawn, historical (verlopen).
API key aanvragen
Registreer op certmap.eu/login.html - je account met eigen API-key wordt direct aangemaakt. Op je dashboard vind je de key en het aantal calls per dag.
Voor commercieel gebruik met hoger volume of samenwerking: api@certmap.eu.