List Datasets#

Prerequisites#

Before you can list existing datasets, make sure that you have:

  • Access to the NeMo Entity Store Microservice.

How to List Datasets#

API#

You can send requests to the NeMo Entity Store Microservice to list datasets.

  1. Make a GET request to the /v1/datasets endpoint.

    export ENTITY_STORE_BASE_URL=<URL for NeMo Entity Store>

curl -X GET "${ENTITY_STORE_BASE_URL}/v1/datasets" \
    -H 'Accept: application/json' \
    -H 'Content-Type: application/json' | jq

  2. Check the dataset’s details by reviewing the response.

    Example Response
      {
  "object": "list",
  "data": [
    {
     "created_at": "2025-02-14T20:47:20.798490",
     "updated_at": "2025-02-14T20:47:20.798492",
     "name": "documentation-test-dataset",
     "namespace": "team-docs",
     "description": "A dataset for documentation testing",
     "format": "json",
     "files_url": "file://documentation-test-dataset.json/",
     "project": "string",
     "custom_fields": {},
     "ownership": {
       "created_by": "user@nvidia.com",
       "access_policies": {}
     }
   }
  ],
  "pagination": {
    "page": 1,
    "page_size": 10,
    "current_page_size": 10,
    "total_pages": 15,
    "total_results": 149
  },
  "sort": "created_at"
}