Returns a ResourceList of the collection’s child datasets (immediate children only). The default is the first 20 datasets, but appending .all() returns a representation for all matching datasets. You can iterate over a ResourceList as you would a list.

The examples below demonstrate how to use .all() and list slicing to obtain the datasets you want.

To get all child datasets (not just immediate children), use datasets.list( ).all() with the in_collection_id argument.

Required arguments


Optional keyword arguments

See datasets.list( ) for a list of supported arguments.


A list of dataset models.

If you append .all(), the SDK returns a ResourceList object representing the entire batch.

If you append a list slicing operator ([]), the SDK returns a Python generator. You can iterate over a generator as you would a list.


Example 1 gets the specified collection and then returns the first 20 child datasets that are immediate children of the specified collection and are tagged with art.

public = enigma.Public()
collection = public.collections.get('bc5c2c88-687e-4da2-93c3-32237ece39f0')
children = collection.child_datasets(has_tag=['art'])

Example 2 returns all datasets that are children of the specified collection as a ResourceList.

collection = public.collections.get('bf068aa3-a15c-4db3-bdb1-6d51f91eae5a')
children = collection.child_datasets().all()