Refactor handlers for better readability

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

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

**Priority**: Low/Medium

Start by locating the handlers under lib and trace how they currently process results. Determine where pagination configuration belongs and identify the existing defaults or conventions to preserve. Done means handlers support configurable pagination with sensible defaults, with behavior verified across the affected paths.

Written by the indexing model from the issue text.