---
title: "List domains"
method: GET
path: "/catalog/v1/domains"
tags: ["Domains"]
---

# List domains

`GET /catalog/v1/domains`

## Request

- Base URL: `https://your-environment.ataccama.one/api`
- URL: `https://your-environment.ataccama.one/api/catalog/v1/domains`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/ataccama/apis/ataccama-one-agentic-data-trust-platform-public-api/docs/catalog/v1/domains/get.ts> (a function with typed inputs; its response is checked against the schema)

List the published domains.

To return extra properties, list the property names you need in the `extraProperties` parameter.
To return stewardship, use the `include` parameter.

Paging is forward-only.

## Query parameters

- `after` string
- `size` integer
- `parentUrn` string: A URN identifying a domain in the Catalog API, or the literal "null", which matches top-level domains (that is, those placed directly under the metadata root). The literal is needed because omitting the value means "do not filter by parent" rather than "parent is null". Format: urn:ata:{tenant}:catalog:domain:{uuid} Example values: - null - urn:ata:acme-corp:catalog:domain:123e4567-e89b-12d3-a456-426614174000
- `search` string
- `name` string
- `sort` string[]
- `extraProperties` string[]
- `include` string[]

## Response `200`

Paginated list of domains.

- 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` Domain[]
    - `urn` string, uri, required: A URN identifying a domain in the Catalog API. Format: urn:ata:{tenant}:catalog:domain:{uuid} Example: urn:ata:acme-corp:catalog:domain:123e4567-e89b-12d3-a456-426614174000.
    - `name` string, required: Name of the domain.
    - `description` string: Description of the domain.
    - `parentUrn` string, uri: A URN identifying a domain in the Catalog API. Format: urn:ata:{tenant}:catalog:domain:{uuid} Example: urn:ata:acme-corp:catalog:domain:123e4567-e89b-12d3-a456-426614174000.
    - `effectiveStewardship` EffectiveStewardship: The stewardship that applies to an entity: either assigned directly to the entity or inherited from an ancestor, such as the source of a catalog item. Resolving effective stewardship takes additional processing time, so request it only when you need it.
      - `groupUrn` string, uri, required: A URN identifying a group resource in the IAM API. To find a group's URN, use the Groups endpoints of the IAM API. Format: urn:ata:{tenant}:iam:group:{uuid} Example: urn:ata:acme-corp:iam:group:123e4567-e89b-12d3-a456-426614174000.
      - `originUrn` string, uri, required: A URN identifying a resource in any realm of the Public API. URNs follow RFC 8141. Format: urn:ata:{tenant}:{realm}:{resource-type}:{uuid} Components: - `urn` — fixed scheme - `ata` — Ataccama namespace - `{tenant}` — tenant identifier from the authentication context - `{realm}` — API realm, for example `catalog` or `reference-data` - `{resource-type}` — resource type within the realm, for example `catalog-item` or `table` - `{uuid}` — UUID (v4 or v7) of the resource Example: urn:ata:acme-corp:reference-data:table:123e4567-e89b-12d3-a456-426614174000.
    - `extraProperties` ExtraProperties: A map of properties associated with the entity defined in the metadata model. Only scalar and reference properties are supported, including arrays. In responses, only properties explicitly requested via the `extraProperties` query parameter are included. In `PATCH` requests, only the properties listed in the body are modified; set a property to `null` (for scalars) or `[]` (for reference arrays) to clear its value. To find which extra properties are available for an entity, retrieve its entity definition through the Metadata model entities endpoints: `catalogItem` for catalog items, `attribute` for catalog attributes, `source` for sources, `folder` for folders, and the term's own `type` (for example, `businessTerm`) for terms.

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