Skip to main content

Catalog unique identifier

The Dateno system assigns each catalog a unique identifier when the catalog is registered in the dataset registry. A catalog unique identifier is a persistent string that uniquely identifies the catalog across all API methods and metadata structures. These identifiers typically follow the format cdi00000xxx (for example cdi00000310).

Catalog unique identifiers remain stable even if the catalog contents change or the catalog is temporarily removed from the registry.

Where catalog unique identifiers appear​

In the Dateno web application, the catalog identifier is displayed in the Source UID field on a dataset card.

In the Dateno API, catalog unique identifiers appear in several places:

  • in the source.uid field of both dataset cards and dataset descriptors;
  • in catalog search results returned by GET /registry/search/catalogs/ as the uid field of each catalog summary;
  • in catalog cards returned by GET /registry/catalog/{catalog_id} as the uid field of the catalog.

Your application can use this identifier to relate datasets to their source catalogs and to look up full catalog metadata.

Using the catalog unique identifier in the API​

In all current versions of the Dateno API, when an endpoint path contains a {catalog_id} parameter (for example in GET /registry/catalog/{catalog_id}), you must pass the catalog unique identifier (uid) as the value of {catalog_id}:

GET /registry/catalog/cdi00000310?apikey=YOUR_API_KEY
Host: api.dateno.io

Using any other value (for example the slug-like id field) in {catalog_id} is not supported.

To retrieve a complete description of a catalog, use the catalog unique identifier with the following endpoint:

For more details on catalog IDs in API paths, see:

Catalog identifier.