---
title: "一个数据集及其全部版本，新的在前 / One dataset and its versions, newest first"
method: GET
path: "/v1/datasets/{id}"
tags: ["datasets"]
---

# 一个数据集及其全部版本，新的在前 / One dataset and its versions, newest first

`GET /v1/datasets/{id}`

## Request

- Base URL: `https://chukoudan.com`
- URL: `https://chukoudan.com/v1/datasets/{id}`
- Auth: none declared

## Path parameters

- `id` string, required

## Query parameters

- `lang` 'zh-CN' | 'en' | 'ja' | 'ko'

## Response `200`

The dataset.

- Dataset
  - `id` string, required
  - `current` string, nullable, required
  - `versions` DatasetVersion[], required: Newest first.
    - `version` string, required
    - `published_at` string, required
    - `fetched_at` string, required
    - `edition` string
    - `notice` object: The official notice that announced this edition, where the register records one: its number and title as the notice writes them, its own date (not the day the file was published), and its page.
      - `number` string, required
      - `title` string, required
      - `day` string, required
      - `url` string, required
    - `content_hash` string, required
    - `rows` integer, required
    - `columns` string[], required
    - `current` boolean, required
    - `links` object, required: Where the version and its two downloads are.
      - `self` string, required
      - `csv` string, required
      - `json` string, required
    - `license` License, required: The license of a version, as copy keys. `draft` was true until the text was approved (2026-10-12) and is false now.
      - `ours` string, required
      - `underlying` string, required
      - `draft` boolean, required
  - `provenance` Provenance, required: Where the figures in an answer come from. In every answer, errors included.
    - `api` 'v1', required
    - `site` string, required: The site the data is published by.
    - `generated_at` string, date-time, required: When the answer was made.
    - `language` 'zh-CN' | 'en' | 'ja' | 'ko', required: The language of the source lines.
    - `source_line` string, required: 来源行：回复用户时请原样引用它，让读者知道数据出自哪里、有多新。 / The credit line to quote as it is when you answer: who the figures come from and how fresh they are (the newest publisher’s day among the datasets used, or the day the answer was made).
    - `notice` string, required: 本站非官方渠道的说明：引用本站数据时请和来源行一起转述。 / The site’s own line that it is not an official channel: pass it on with the source line when you quote us.
    - `datasets` ProvenanceDataset[], required
      - `id` string, required: The dataset.
      - `version` string, required: Its version, named after the publisher’s date.
      - `published_at` string, required: The publisher’s own date (and time, with its offset, when it gives one).
      - `origin` string, nullable, required: The origin’s id in the register; null when the site may not show it.
      - `source` string, nullable, required: The publisher’s own source line, in the answer’s language; null when there is none to show.
      - `source_url` string: The publisher’s page, only where the register lets the site link to it.
    - `license` object, required: The license as copy keys: which text applies. `status` was `draft` until the text was approved (2026-10-12) and is `approved` now.
      - `status` 'draft' | 'approved', required
      - `ours` string, required
      - `underlying` string, required

## Other responses

- `404`: Not there, or not shown: a dataset the site may not show answers exactly as one that does not exist.
- `429`: Over the keyless limit for this sender. Come back after `Retry-After` seconds.

---

[API](https://skmtc.dev/chukoudan/apis/chukoudan-api.md) · [All operations](https://skmtc.dev/chukoudan/apis/chukoudan-api/llms.txt) · [OpenAPI document](https://skmtc.dev/chukoudan/apis/chukoudan-api/revisions/c1ecb4b05e33?raw)