Pagination

The current public list endpoints return direct collections. Design your client so it can evolve to cursors, filters or page numbers without rewriting your application contract.

Recommendation

• Wrap list access behind adapters.
• Treat empty arrays as a valid business state.
• Do not assume implicit ordering unless your own domain layer makes that explicit.

When formal pagination is introduced, it will appear in the changelog first and then in OpenAPI.