Download a dataset

Download one complete set of observations as a single JSON file. Much easier than paging through thousands of requests when you want everything.

get

https://api.ukdataatlas.com/v1/exports/{export-id}

Good to know

This response isn't wrapped in the usual envelope: it's the file itself.

Path parameters

export-idstringrequired
An export id from GET /v1/exports; one source partition of one measure.

Returns

object

The complete source observation artifact.

Header Content-Disposition

Suggested immutable JSON filename.

When it goes wrong

404No resource matches that identity.
503The referenced build artifact has not been built yet.

Every error has the same shape. See Errors for how to handle them.

Technical notes

Show the precise behaviour

Returns the exact JSON artifact listed by /exports, after checking its content hash against the manifest. This response is intentionally not wrapped in the usual API envelope.

Request

curl "https://api.ukdataatlas.com/v1/exports/total-jobs-observations"

Response200

{
  "apiVersion": "v1",
  "atlasRelease": "sha256:5c4aa4529cbfbd5e4c844c55cddba1ef04a7bf76f3eaa085a357fff401af6d0c",
  "data": {
    "id": "total-jobs-observations",
    "measureId": "total-jobs",
    "datasetId": "jobs"
  },
  "meta": {
    "nextCursor": null
  }
}