Version 0

Version 0 of the API is not considered stable, and it may change in backwards-incompatible ways without notice.

Base URL: https://api.ov.duinn.nl

GET /api/v0/emissions?...

Returns raw emission data. Output format is not yet properly documented. Just eyeball it for now. Query parameters:

format (deprecated alias: output)

• json (default)
• csv
• text (same as csv except with a text/plain content type, to make it show up in the browser rather than downloading)
• geojson (only with group_by=grid_total and group_by=grid_concession)

group_by

• total (default)
• concession_authority
• concession
• line (not currently available)
• grid_total (aggregated over 1×1 km squares)
• grid_concession (aggregated over 1×1 km squares)

time_period

Deprecated: use years=all or months=all instead.

• year (default)
• month

years

years and months are mutually exclusive.

• a 4-digit year, e.g. 2017
• a range of those, separated with a hyphen, e.g. 2017-2019
• all (default)

months

years and months are mutually exclusive.

• a 6-digit month in yyyymm format, e.g. 201703
• a range of those, separated with a hyphen, e.g. 201701-201712
• all

transport_type

Comma separated list of:

• bus (default for now, for backwards compatibility)
• tram
• metro
• train
• all (meaning all of the above)

Values should be specified in lowercase, but are case insensitive for backwards compatibility.

Requesting just one transport type removes that nesting level from the JSON output (for backwards compatibility).

fields

• all (default)
• a comma-separated list of the names of data fields to fetch

GET /api/v0/emissions/graph?...

Plots the data in a chart. Query parameters:

group_by, time_period

Same as above.

y_axis

The name of the data column to plot (default: numTrips).

Example

https://api.ov.duinn.nl/api/v0/emissions?output=csv&group_by=concession&time_period=month

License

This data is published under the Creative Commons Attribution-NonCommercial 4.0 International (CC BY-NC 4.0) license:

• Summary (English)
• Summary (Dutch)
• Full legal code (English)
• Full legal code (Dutch)

For attribution, the following is acceptable:

Duinn, Openbaar Vervoer OpenData, 2019 (https://ov.duinn.nl)

If you would like to use this data under different license terms, please contact us.