---
title: "Get Dataset by Tracking ID"
method: GET
path: "/api/dataset/tracking_id/{tracking_id}"
tags: ["Dataset"]
---

# Get Dataset by Tracking ID

`GET /api/dataset/tracking_id/{tracking_id}`

Auth'ed user or api key must have an admin or owner role for the specified dataset's organization.

## Path parameters

- `tracking_id` string, required

## Headers

- `TR-Organization` string, uuid, required

## Response `200`

Dataset retrieved successfully

- Dataset
  - `created_at` string, date-time, required — Timestamp of the creation of the dataset
  - `deleted` integer, required — Flag to indicate if the dataset has been deleted. Deletes are handled async after the flag is set so as to avoid expensive search index compaction.
  - `id` string, uuid, required — Unique identifier of the dataset, auto-generated uuid created by Trieve
  - `name` string, required — Name of the dataset
  - `organization_id` string, uuid, required — Unique identifier of the organization that owns the dataset
  - `server_configuration` unknown, required
  - `tracking_id` string, nullable — Tracking ID of the dataset, can be any string, determined by the user. Tracking ID's are unique identifiers for datasets within an organization. They are designed to match the unique identifier of the dataset in the user's system.
  - `updated_at` string, date-time, required — Timestamp of the last update of the dataset

## Other responses

- `400` — Service error relating to retrieving the dataset
- `404` — Dataset not found

---

[API](https://skmtc.net/devflowinc/apis/trieve-api.md) · [All operations](https://skmtc.net/devflowinc/apis/trieve-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/devflowinc/trieve-api/revisions/84583e7c9fc1/schema)