Use downloads for complete ingestion
Use a query for bounded interactive reads and a download when the job must ingest the complete release. Downloads are addressed by dataset and release IDs, preserving the same reproducibility model.
Choose a declared format
| format | Response type | Typical use |
|---|---|---|
| jsonl | application/x-ndjson | Streaming and line-oriented pipelines |
| csv | text/csv | Tabular tools and interoperable exports |
| parquet | application/octet-stream | Columnar analytics workflows |
Stream instead of buffering
cURL
curl --fail --location \
"https://api.datasets.nordicdevhouse.com/v1/datasets/finnish-vehicle-market-listings/releases/dsv-preview-finnish-vehicle-market-listings/download?format=jsonl" \
-H "Authorization: Bearer $DATASET_API_KEY" \
-H "X-API-Version: 1" \
--output release.jsonlWrite to a temporary location, validate that the transfer completed, then atomically promote the file into downstream processing. Avoid loading an entire release into memory.