Update handlers documentation

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

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

**Priority**: Low/Medium

Start by locating the handlers and pagination-related code under lib, then trace how results are produced and returned. Define the configurable pagination settings and sensible defaults from the existing behavior; done means handlers support pagination without breaking current callers and the relevant behavior is covered or documented.

Written by the indexing model from the issue text.