---
title: "Retrieve a dataset"
method: GET
path: "/v2/datasets/{dataset_id}"
tags: ["Datasets"]
---

# Retrieve a dataset

`GET /v2/datasets/{dataset_id}`

Retrieves a specific dataset by its unique identifier

## Path parameters

- `dataset_id` union, required — The unique identifier of the dataset
  - string
  - string, ulid — The id of the resource

## Response `200`

Dataset retrieved successfully. Returns the complete dataset object.

- object
  - `_id` union, required — The unique identifier of the dataset
    - string
    - string, ulid — The id of the resource
  - `display_name` string, required — The display name of the dataset
  - `project_id` union, required — The unique identifier of the project it belongs to
    - string
    - string, ulid — The id of the resource
  - `workspace_id` union, required — The unique identifier of the workspace it belongs to
    - string
    - string, ulid — The id of the resource
  - `metadata` object, required
    - `total_versions` number, required
    - `datapoints_count` number, required
  - `created_by_id` union — The unique identifier of the user who created the dataset
    - string
    - string, ulid — The id of the resource
  - `updated_by_id` union — The unique identifier of the user who last updated the dataset
    - string
    - string, ulid — The id of the resource
  - `created` union — The date and time the resource was created
    - string, date-time
    - string, date-time
  - `updated` union — The date and time the resource was last updated
    - string, date-time
    - string, date-time

## Other responses

- `404` — Dataset not found with the given id

---

[API](https://skmtc.net/orq-ai/apis/orq-ai-api.md) · [All operations](https://skmtc.net/orq-ai/apis/orq-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/orq-ai/orq-ai-api/versions/6a22c53a2580/schema)