---
title: "One dataset with its served series and the citation block."
method: GET
path: "/v1/sources/{source}/datasets/{datasetId}"
---

# One dataset with its served series and the citation block.

`GET /v1/sources/{source}/datasets/{datasetId}`

## Request

- Base URL: `https://starwell.dev/api/starwell`
- URL: `https://starwell.dev/api/starwell/v1/sources/{source}/datasets/{datasetId}`
- Auth: one of:
  - HTTP bearer
  - none

A wide dataset holds thousands of series: data.series pages with limit + offset, and meta.series carries count/total/offset/hasMore for that list.

## Path parameters

- `source` string, required
- `datasetId` string, required

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

OK

- object
  - `success` true, required
  - `data` object, required
  - `meta` object
    - `citation` Citation
      - `source` string
      - `authority` string, nullable
      - `dataset` string
      - `datasetExternalId` string
      - `url` string, nullable: Human-facing official table page.
      - `termsUrl` string, nullable
      - `text` string: Ready-to-print citation line.
    - `series` object
      - `count` integer: Rows in THIS response.
      - `total` integer: Rows matching the query across all pages.
      - `offset` integer: The offset this page starts at (echoed back).
      - `hasMore` boolean: True when rows exist past this page — fetch them with offset = offset + the number of rows returned here.

## Other responses

- `400`: Invalid parameters.
- `404`: Unknown source, dataset, or series.

---

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