Download files

Get the actual data. Listing available files is public; downloading full exports, coordinates, or archives consumes credits and requires the right addon on your organization.

To send the key, use the X-API-Key header, see Authentication. Credit costs and rate limits are in Rate limits & credits.

List available files (public)

GET /v1/dataset/:table/files

Public, costs no credits. Returns the asset URLs and the export files available for the dataset, so you know which formats exist before spending credits.

curl "https://api.topolab.nl/v1/dataset/transport_infrastructure_bushaltes/files"

{
  "table": "transport_infrastructure_bushaltes",
  "exports": [
    { "format": "csv",     "url": "https://api.topolab.nl/v1/dataset/transport_infrastructure_bushaltes/files/csv",     "credits": 10 },
    { "format": "json",    "url": "https://api.topolab.nl/v1/dataset/transport_infrastructure_bushaltes/files/json",    "credits": 10 },
    { "format": "geojson", "url": "https://api.topolab.nl/v1/dataset/transport_infrastructure_bushaltes/files/geojson", "credits": 10 },
    { "format": "kml",     "url": "https://api.topolab.nl/v1/dataset/transport_infrastructure_bushaltes/files/kml",     "credits": 10 },
    { "format": "shp",     "url": "https://api.topolab.nl/v1/dataset/transport_infrastructure_bushaltes/files/shp",     "credits": 10 }
  ]
}

Download a full export

GET /v1/dataset/:table/files/:format

Requires an X-API-Key with READ permission on the DATASET resource, and the API_ACCESS addon on your organization. Costs 10 credits per download. Supported formats: csv, json, geojson, kml, shp.

curl -H "X-API-Key: tlb_prod_..." \
  "https://api.topolab.nl/v1/dataset/transport_infrastructure_bushaltes/files/geojson" \
  -o transport_infrastructure_bushaltes.geojson

The endpoint streams the file; use -o to save it. GeoJSON and KML carry WGS84 (EPSG:4326) geometry; CSV and JSON include longitude/latitude columns in the same reference system. SHP is delivered as a zipped shapefile bundle.

Coordinates only

GET /v1/dataset/:table/coordinates

The bulk lon/lat sibling of a full download. Requires an X-API-Key with the API_ACCESS addon. Costs 15 credits. Returns a JSON array of WGS84 lng/lat pairs, useful for plotting points on a map without pulling every attribute.

curl -H "X-API-Key: tlb_prod_..." \
  "https://api.topolab.nl/v1/dataset/transport_infrastructure_bushaltes/coordinates"

[
  { "lng": 4.8952, "lat": 52.3702 },
  { "lng": 4.4777, "lat": 51.9244 },
  { "lng": 5.1214, "lat": 52.0907 }
]

Coordinates are WGS84 (EPSG:4326) only.

Historical archives

Past refreshes are retained as monthly snapshots.

List archive months (public)

GET /v1/dataset/:table/archives/list

Public, costs no credits. Returns the months available as snapshots.

curl "https://api.topolab.nl/v1/dataset/transport_infrastructure_bushaltes/archives/list"

{
  "table": "transport_infrastructure_bushaltes",
  "months": ["2026-05", "2026-04", "2026-03", "2026-02"]
}

Download an archive month

GET /v1/dataset/:table/archives/:month/:format

Requires X-API-Key and the ARCHIVED_DATA addon. Credit cost scales with your plan: 20 on Basic, 10 on Team, 0 on Enterprise. month is YYYY-MM; format is one of csv, json, geojson, kml, shp.

curl -H "X-API-Key: tlb_prod_..." \
  "https://api.topolab.nl/v1/dataset/transport_infrastructure_bushaltes/archives/2026-04/csv" \
  -o transport_infrastructure_bushaltes-2026-04.csv

Errors

Status	Meaning
401	Missing or invalid X-API-Key.
403	Key lacks the required permission (READ on DATASET) or the required addon, API_ACCESS for downloads and coordinates, ARCHIVED_DATA for archives.
404	Unknown table, unsupported format, or an archive month that is not available.
429	Rate limited, see Rate limits & credits.

Don't have the addon yet? Contact us to enable API_ACCESS or ARCHIVED_DATA.

Next

• Sample rows, inspect the schema for free before downloading.
• Refresh hooks, detect when a dataset has changed.
• Usage stats, track credit consumption.