API v1

Dokumentation der öffentlichen API

Schreibgeschützter Zugriff auf veröffentlichte Datensätze und Evidenzmetadaten.

Endpoints

GET /api/v1/countriesGET /api/v1/facilitiesGET /api/v1/routesGET /api/v1/dossiersGET /api/v1/evidenceGET /api/v1/regulationsGET /api/v1/eol-volumesGET /api/v1/sources

Query parameters

limit (1–100), offset, country_slug, operational_status, evidence_level, jurisdiction, stream, data_basis (model | company_reported | verified | missing — facilities, countries, eol-volumes). Labelled resources return data_basis[] and missing_fields[] per record.

Versioning & pagination

The URL and X-API-Version header identify v1. Responses include count, limit and offset.

Access & rate limits

Published records only. GET and OPTIONS are available; mutation methods are not exposed. Current guideline: 60 requests per minute.

Citation

Cite Circular Turf Europe, the endpoint URL, API version, access date, record last_verified date, and the original source URL where supplied.

Missing data

Null or absent values mean unknown or not published. They must not be interpreted as zero.

TypeScript

Responses follow PublicApiResponse<T>: api_version, resource, count, limit, offset and data[].