Update api documentation

**Description**
Currently utils lacks proper pagination support.

**Proposed solution**
Add configurable pagination with sensible defaults.

**Priority**: Low/Medium

Start by locating the utils code and the API documentation entry point, then determine where pagination behavior and configuration belong. Done means pagination is configurable with sensible defaults and the API documentation accurately describes the resulting behavior.

Written by the indexing model from the issue text.