Get a Dataset

GET/v1/datasets/{id}Get a Dataset

Retrieve a dataset by ID. See 'Datasets' for more information.

Parameters

idstringpathrequired

pattern ^(?!usage$).*$

X-Client-Namestringheader

The name of the project that is making the request.

Responses

object

datasetobjectrequired

Show child attributes

created_atstring · date-timerequired

The creation date

dataset_partsarray of object

the underlying files that make up the dataset

Show child attributes

Show array items

idstringrequired

The dataset part ID

indexinteger · int32

The index of the file

namestringrequired

The name of the dataset part

num_rowsinteger · int32

The number of rows in the file

original_urlstring

The download url of the original file

samplesarray of string

The first few rows of the parsed file

Show child attributes

size_bytesinteger · int32

The size of the file in bytes

urlstring

The download url of the file

dataset_typestringrequired

The type of the dataset

one of "embed-input", "embed-result", "cluster-result", "cluster-outliers", "reranker-finetune-input", "single-label-classification-finetune-input", "chat-finetune-input", "multi-label-classification-finetune-input", "batch-chat-input", "batch-openai-chat-input", "batch-embed-v2-input", "batch-chat-v2-input"

idstringrequired

The dataset ID

metricsobject

Show child attributes

finetune_dataset_metricsobject

Show child attributes

chat_data_metricsobject

Show child attributes

num_eval_turnsnumber · int64

The sum of all turns of valid eval examples.

num_train_turnsnumber · int64

The sum of all turns of valid train examples.

preamblestring

The preamble of this dataset.

classify_data_metricsobject

Show child attributes

label_metricsarray of object

Show child attributes

Show array items

labelstring

value of the label

samplesarray of string

samples for this label

Show child attributes

total_examplesnumber · int64

Total number of examples for this label

eval_examplesnumber · int64

Number of evaluation examples.

eval_size_bytesnumber · int64

The size in bytes of all eval examples.

reranker_data_metricsobject

Show child attributes

num_eval_hard_negativesnumber · int64

The sum of all hard negatives of valid eval examples.

num_eval_queriesnumber · int64

The number of evaluation queries.

num_eval_relevant_passagesnumber · int64

The sum of all relevant passages of valid eval examples.

num_train_hard_negativesnumber · int64

The sum of all hard negatives of valid training examples.

num_train_queriesnumber · int64

The number of training queries.

num_train_relevant_passagesnumber · int64

The sum of all relevant passages of valid training examples.

total_examplesnumber · int64

The overall number of examples.

train_examplesnumber · int64

The number of training examples.

train_size_bytesnumber · int64

The size in bytes of all training examples.

trainable_token_countnumber · int64

The number of tokens of valid examples that can be used for training.

namestringrequired

The name of the dataset

parse_infoobject

Show child attributes

delimiterstring

separatorstring

preserve_fieldsarray of string

Show child attributes

required_fieldsarray of string

Show child attributes

schemastring

the avro schema of the dataset

updated_atstring · date-timerequired

The last update date

validation_errorstring

Errors found during validation

validation_statusstringrequired

The validation status of the dataset

one of "unknown", "queued", "processing", "failed", "validated", "skipped"

validation_warningsarray of string

warnings found during validation

Show child attributes

Example response

{
  "dataset": {
    "created_at": "2026-06-09T00:00:00Z",
    "dataset_parts": [
      {
        "id": "string",
        "index": 0,
        "name": "string",
        "num_rows": 0,
        "original_url": "string",
        "samples": [
          "string"
        ],
        "size_bytes": 0,
        "url": "string"
      }
    ],
    "dataset_type": "batch-chat-input",
    "id": "string",
    "metrics": {
      "finetune_dataset_metrics": {
        "chat_data_metrics": {
          "num_eval_turns": 0,
          "num_train_turns": 0,
          "preamble": "string"
        },
        "classify_data_metrics": {
          "label_metrics": [
            {
              "label": "string",
              "samples": [
                "string"
              ],
              "total_examples": 0
            }
          ]
        },
        "eval_examples": 0,
        "eval_size_bytes": 0,
        "reranker_data_metrics": {
          "num_eval_hard_negatives": 0,
          "num_eval_queries": 0,
          "num_eval_relevant_passages": 0,
          "num_train_hard_negatives": 0,
          "num_train_queries": 0,
          "num_train_relevant_passages": 0
        },
        "total_examples": 0,
        "train_examples": 0,
        "train_size_bytes": 0,
        "trainable_token_count": 0
      }
    },
    "name": "string",
    "parse_info": {},
    "preserve_fields": [
      "string"
    ],
    "required_fields": [
      "string"
    ],
    "schema": "string",
    "updated_at": "2026-06-09T00:00:00Z",
    "validation_error": "string",
    "validation_status": "failed",
    "validation_warnings": [
      "string"
    ]
  }
}

object

idstring

messagestring

Example response

{
  "id": "string",
  "message": "string"
}

object

idstring

messagestring

Example response

{
  "id": "string",
  "message": "string"
}

object

idstring

messagestring

Example response

{
  "id": "string",
  "message": "string"
}

object

idstring

messagestring

Example response

{
  "id": "string",
  "message": "string"
}

object

idstring

messagestring

Example response

{
  "id": "string",
  "message": "string"
}

object

idstring

messagestring

Example response

{
  "id": "string",
  "message": "string"
}

object

idstring

messagestring

Example response

{
  "id": "string",
  "message": "string"
}

object

idstring

messagestring

Example response

{
  "id": "string",
  "message": "string"
}

object

idstring

messagestring

Example response

{
  "id": "string",
  "message": "string"
}

object

idstring

messagestring

Example response

{
  "id": "string",
  "message": "string"
}

object

idstring

messagestring

Example response

{
  "id": "string",
  "message": "string"
}

object

idstring

messagestring

Example response

{
  "id": "string",
  "message": "string"
}

Examples

idrequiredpath parameter

X-Client-Nameheader parameter

curl -X GET 'https://api.cohere.com/v1/datasets/string'

const response = await fetch('https://api.cohere.com/v1/datasets/string', { method: 'GET' });
const data = await response.json();

const response = await fetch('https://api.cohere.com/v1/datasets/string', { method: 'GET' });
console.log(await response.json());

import requests

response = requests.request("GET", "https://api.cohere.com/v1/datasets/string")
print(response.json())

package main

import (
	"context"
	"net/http"
)

func main() {
	ctx := context.Background()
	req, err := http.NewRequestWithContext(ctx, "GET", "https://api.cohere.com/v1/datasets/string", nil)
	if err != nil {
		panic(err)
	}
	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()
}

<?php
$request = curl_init("https://api.cohere.com/v1/datasets/string");
curl_setopt($request, CURLOPT_CUSTOMREQUEST, "GET");
$response = curl_exec($request);
curl_close($request);

var request = HttpRequest.newBuilder(URI.create("https://api.cohere.com/v1/datasets/string"))
    .method("GET", HttpRequest.BodyPublishers.noBody())
    .build();
var response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());

require 'net/http'

uri = URI("https://api.cohere.com/v1/datasets/string")
request = Net::HTTPGenericRequest.new("GET", false, true, uri)
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }

using var client = new HttpClient();
using var request = new HttpRequestMessage(HttpMethod.Get, "https://api.cohere.com/v1/datasets/string");
using var response = await client.SendAsync(request);

{
  "dataset": {
    "created_at": "2026-06-09T00:00:00Z",
    "dataset_parts": [
      {
        "id": "string",
        "index": 0,
        "name": "string",
        "num_rows": 0,
        "original_url": "string",
        "samples": [
          "string"
        ],
        "size_bytes": 0,
        "url": "string"
      }
    ],
    "dataset_type": "batch-chat-input",
    "id": "string",
    "metrics": {
      "finetune_dataset_metrics": {
        "chat_data_metrics": {
          "num_eval_turns": 0,
          "num_train_turns": 0,
          "preamble": "string"
        },
        "classify_data_metrics": {
          "label_metrics": [
            {
              "label": "string",
              "samples": [
                "string"
              ],
              "total_examples": 0
            }
          ]
        },
        "eval_examples": 0,
        "eval_size_bytes": 0,
        "reranker_data_metrics": {
          "num_eval_hard_negatives": 0,
          "num_eval_queries": 0,
          "num_eval_relevant_passages": 0,
          "num_train_hard_negatives": 0,
          "num_train_queries": 0,
          "num_train_relevant_passages": 0
        },
        "total_examples": 0,
        "train_examples": 0,
        "train_size_bytes": 0,
        "trainable_token_count": 0
      }
    },
    "name": "string",
    "parse_info": {},
    "preserve_fields": [
      "string"
    ],
    "required_fields": [
      "string"
    ],
    "schema": "string",
    "updated_at": "2026-06-09T00:00:00Z",
    "validation_error": "string",
    "validation_status": "failed",
    "validation_warnings": [
      "string"
    ]
  }
}

{
  "id": "string",
  "message": "string"
}

{
  "id": "string",
  "message": "string"
}

{
  "id": "string",
  "message": "string"
}

{
  "id": "string",
  "message": "string"
}

{
  "id": "string",
  "message": "string"
}

{
  "id": "string",
  "message": "string"
}

{
  "id": "string",
  "message": "string"
}

{
  "id": "string",
  "message": "string"
}

{
  "id": "string",
  "message": "string"
}

{
  "id": "string",
  "message": "string"
}

{
  "id": "string",
  "message": "string"
}

{
  "id": "string",
  "message": "string"
}

Search documentation

/datasets

/connectors

/embed-jobs

/finetuning

/models

/audio/transcriptions

/batches

Operations

Parameters

Responses

/datasets

/connectors

/embed-jobs

/finetuning

/models

/audio/transcriptions

/batches

Operations