---
title: "List datasets"
method: GET
path: "/pipeline-monitoring/v1/datasets"
tags: ["Datasets"]
---

# List datasets

`GET /pipeline-monitoring/v1/datasets`

## Request

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

List the observed datasets.

To find the dataset matched to a catalog item, use the `catalogItemUrn` parameter. Each catalog item
matches at most one dataset, so the response contains one dataset or none.

Paging is forward-only.

## Query parameters

- `after` string
- `size` integer
- `sort` string
- `catalogItemUrn` string, uri: A URN identifying a catalog item resource in the Catalog API. Format: urn:ata:{tenant}:catalog:catalog-item:{uuid} Example: urn:ata:acme-corp:catalog:catalog-item:123e4567-e89b-12d3-a456-426614174000.

## Response `200`

Paginated list of datasets.

- object
  - `meta` PaginationMetadata
    - `next` string: Encoded string representing the next page. Omitted if there are no more pages.
    - `total` integer: Total number of items available across all pages.
  - `data` DatasetResponse[]
    - `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.

---

[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)