API v1

Documentation de l’API publique

Accès en lecture seule aux dossiers publiés et à leurs métadonnées de preuve.

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[].