---
title: "Get dataset"
method: GET
path: "/pipeline-monitoring/v1/datasets/{datasetUrn}"
tags: ["Datasets"]
---

# Get dataset

`GET /pipeline-monitoring/v1/datasets/{datasetUrn}`

## Request

- Base URL: `https://your-environment.ataccama.one/api`
- URL: `https://your-environment.ataccama.one/api/pipeline-monitoring/v1/datasets/{datasetUrn}`
- Auth: HTTP bearer

Retrieve a dataset by URN.

URL-encode the dataset URN when placing it in the request path. Each colon (`:`) becomes `%3A`.

## Path parameters

- `datasetUrn` string, uri, required: URN of an observed dataset. Format: urn:ata:{tenant}:pipeline-monitoring:dataset:{uuid} Example: urn:ata:acme-corp:pipeline-monitoring:dataset:0197f3a0-7777-7c0c-8f9d-3a2b4c5d6e7f.

## Response `200`

The requested dataset.

- DatasetResponse: A physical data asset, such as a table, observed as an input or output of pipeline jobs. The same physical table can also be cataloged, once for each source it appears in; `catalogItemUrns` lists the catalog items this dataset has been matched to.
  - `urn` string, uri, required: URN of an observed dataset. Format: urn:ata:{tenant}:pipeline-monitoring:dataset:{uuid} Example: urn:ata:acme-corp:pipeline-monitoring:dataset:0197f3a0-7777-7c0c-8f9d-3a2b4c5d6e7f.
  - `name` string, required: The fully qualified dataset name as observed (the OpenLineage full name), for example, `warehouse.public.customers`. The combination of `name` and `namespace` is unique across all datasets.
  - `namespace` string, required: The OpenLineage namespace of the dataset, which identifies the data store it lives in, for example, `postgres://warehouse:5432`.
  - `dataStoreName` string, required: The name of the data store the dataset belongs to.
  - `catalogItemUrns` CatalogItemUrn[], required: The URNs of the catalog items matched to the dataset. The list is empty while the dataset is not matched to any catalog item. To get the details of a catalog item, use the Catalog API.
  - `createdAt` string, date-time, required: When the dataset was first recorded.

## Other responses

- `400`: Bad request. The request parameters or body are invalid.
- `403`: Forbidden. You do not have permission to access the requested resource.
- `404`: Not found. The requested resource does not exist.

---

[API](https://skmtc.dev/ataccama/apis/ataccama-one-agentic-data-trust-platform-public-api.md) - [All operations](https://skmtc.dev/ataccama/apis/ataccama-one-agentic-data-trust-platform-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ataccama/apis/ataccama-one-agentic-data-trust-platform-public-api/revisions/46f16e0487f8?raw)