Package Listing API¶

User Story¶

As the system

I want to return package search results efficiently

So that users receive fast, paginated results.

API¶

POST /api/packages/search

Request¶

{
 "destination":"Turkey",
 "departureDate":"2026-09-10",
 "returnDate":"2026-09-18",
 "adults":2,
 "children":1
}

Response¶

{
 "totalResults":126,
 "page":1,
 "packages":[]
}

Acceptance Criteria¶

Response under 2 seconds

Supports pagination

Supports filters

Supports sorting

Supports caching