API v1

Public API documentation

Read-only access to published Circular Turf Europe records and their evidence metadata.

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