Listings API

Endpoints

List Listings (Public)


GET /api/listings

Query Parameters:

Param	Type	Description
`type`	string	`house\|apartment\|townhouse\|land\|commercial`
`status`	string	`for_sale\|for_rent\|sold\|leased`
`price_min`	number	Minimum price (AUD)
`price_max`	number	Maximum price (AUD)
`bedrooms`	number	Minimum bedrooms
`suburb`	string	Suburb name filter
`page`	number	Page number (default: 1)
`per_page`	number	Results per page (default: 20, max: 100)

Get Listing (Public)


GET /api/listings/[id]

Returns full listing with media URLs, agent info, and open home schedule.

Create Listing


POST /api/listings
Authorization: Bearer <jwt> (agent+)
Content-Type: application/json

Required fields: title, type, status, price, address, suburb, state, postcode, bedrooms, bathrooms, parking

Update Listing


PATCH /api/listings/[id]
Authorization: Bearer <jwt> (owner or broker)

Request Showing (Public)


POST /api/listings/[id]/request-showing
Content-Type: application/json
 
{ "name": "Jane Smith", "email": "jane@example.com", "phone": "0400000000", "message": "Interested in viewing this Saturday" }

Creates a lead and a showing request simultaneously.