client.datasets.get()

import { createClient } from "@toloka-platform/sdk";

const client = createClient({
  baseUrl: "https://platform.toloka.ai",
  apiKey: process.env.TOLOKA_API_KEY!,
});

const dataset = await client.datasets.get({
  datasetId: "ds.019a0000-0000-7000-8000-000000000001"
});
console.log(dataset);

{
  "id": "ds.019a0000-0000-7000-8000-000000000001",
  "projectId": "pp.019a0000-0000-7000-8000-000000000001",
  "name": "<string>",
  "hidden": false,
  "profile": null,
  "createdAt": "2026-01-01T00:00:00Z"
}

import { createClient } from "@toloka-platform/sdk";

const client = createClient({
  baseUrl: "https://platform.toloka.ai",
  apiKey: process.env.TOLOKA_API_KEY!,
});

const dataset = await client.datasets.get({
  datasetId: "ds.019a0000-0000-7000-8000-000000000001"
});
console.log(dataset);

{
  "id": "ds.019a0000-0000-7000-8000-000000000001",
  "projectId": "pp.019a0000-0000-7000-8000-000000000001",
  "name": "<string>",
  "hidden": false,
  "profile": null,
  "createdAt": "2026-01-01T00:00:00Z"
}

Return the dataset name, project, profile, and creation time. Use the fields or items endpoints to inspect its contents.

Signature

Method signature on client.datasets:

get(args: {
  datasetId: string;
}): Promise<Dataset>;

Parameters

string

required

Dataset ID with prefix ds..

Returns

Promise<Dataset> A dataset within a project.

DatasetId

required

Dataset ID with prefix ds..

ProjectId

required

Project ID with prefix pp..

string

required

Name of the dataset.

boolean

required

Whether the dataset is hidden from ordinary dataset lists.

DatasetProfileStamp | null

required

Profile used to create the dataset fields, or null for a dataset without a profile.

Show Fields

"chat-sft" | "instruction"

required

Profile name: chat-sft for chat training examples or instruction for prompt and completion pairs.

number

required

Version of the profile definition used when the dataset was created.

string

required

Time the dataset was created, as an ISO 8601 timestamp.

Errors

HTTP errors throw PotatoApiError. The endpoint documents these error responses:

Status	Description
404	Dataset not found
429	Rate limit exceeded

HTTP endpoint: GET /datasets/{datasetId}.

import { createClient } from "@toloka-platform/sdk";

const client = createClient({
  baseUrl: "https://platform.toloka.ai",
  apiKey: process.env.TOLOKA_API_KEY!,
});

const dataset = await client.datasets.get({
  datasetId: "ds.019a0000-0000-7000-8000-000000000001"
});
console.log(dataset);

{
  "id": "ds.019a0000-0000-7000-8000-000000000001",
  "projectId": "pp.019a0000-0000-7000-8000-000000000001",
  "name": "<string>",
  "hidden": false,
  "profile": null,
  "createdAt": "2026-01-01T00:00:00Z"
}

Reference

TypeScript SDK

CLI

HTTP API

Signature

Parameters

Returns

Errors

​Signature

​Parameters

​Returns

​Errors

Signature

Parameters

Returns

Errors