Update routes documentation

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

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

**Priority**: Low/Medium

Start by locating the routes documentation and the current route-handling entry point. Determine how pagination should be configured and what defaults are considered sensible, then verify that the documented behavior matches the implemented routes and pagination behavior.

Written by the indexing model from the issue text.