Property Listing API - Githubissues

rollymaduk / new-gitunion-single-test

0 stars 0 forks source link

Property Listing API #13

Open git-union-dev[bot] opened 7 months ago

git-union-dev[bot] commented 7 months ago

Property Listing API

As a registered user, I want to be able to view a list of properties so that I can browse through available real estate options.

Acceptance Criteria

[ ] API endpoint /api/properties is available.
[ ] Requesting user must be authenticated before accessing the property list.
[ ] API returns a list of properties with details including title, price, location, and number of bedrooms.
[ ] Users can filter properties by price range, location, and property type.
[ ] Users can sort properties by price, date listed, and popularity.
[ ] Response is in JSON format with proper status codes.

[ ] API pagination is supported to handle large result sets efficiently.

sequenceDiagram
participant User
participant Auth
participant API
User->>+Auth: Request (with credentials)
Auth-->>-User: Response (Authenticated)
User->>+API: GET /api/properties
API-->>-User: Property list JSON