---
title: "Dataset with latest version, versions, findings and preview"
method: GET
path: "/api/v1/datasets/{id}"
---

# Dataset with latest version, versions, findings and preview

`GET /api/v1/datasets/{id}`

## Request

- Base URL: `https://rows.page`
- URL: `https://rows.page/api/v1/datasets/{id}`
- Auth: one of:
  - none
  - HTTP bearer
  - API key in header `X-Rows-Token`

## Response `200`

OK

- DatasetResponse
  - `dataset` DatasetMeta
    - `id` string
    - `url` string
    - `title` string, nullable
    - `summary` string, nullable
    - `visibility` 'public' | 'private'
    - `id_column` string, nullable
    - `latest_version` integer
    - `source_url` string, nullable
    - `created_at` string
    - `updated_at` string
    - `expires_at` string, nullable
    - `owned` boolean
    - `key` string, nullable
  - `version` object: Requested (or latest) version with data_url, raw_url, locked, purged
  - `versions` object[]: Newest first
  - `findings` Finding[]
    - `id` string
    - `version` integer, nullable
    - `title` string
    - `note` string, nullable
    - `view` object
      - `q` string
      - `sort` string
      - `cols` string
      - `sql` string
    - `row_count` integer, nullable
    - `position` integer
    - `created_via` string
    - `created_at` string
  - `preview` object, nullable
    - `columns` Column[]
      - `name` string, required: Dot path for nested fields
      - `type` string, required
    - `rows` array[]
      - unknown[]
        - unknown
    - `truncated` boolean
    - `json_path` string, nullable
  - `viewer` object
    - `is_owner` boolean
    - `plan` string, nullable

## Other responses

- `401`: Error
- `403`: Error
- `404`: Error
- `410`: Error

---

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