Refactor models for better readability

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

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

**Priority**: Low/Medium

Start by locating the API entry points and reviewing how list responses are currently produced. Define the configurable pagination behavior and sensible defaults, then verify that API results support pagination consistently and that existing behavior remains compatible.

Written by the indexing model from the issue text.