Own-listing lifecycle

A listing you own moves through a small set of statuses, expires two months after it is renewed, and keeps a history of every change. These endpoints use the same /properties routes and scopes as Create and update listings.

Statuses

active · inactive · pending · sold · rented · deleted

There is no API route that returns a sold, rented or deleted listing to active.

Change status

PUT /properties/:id

Send status alone to close a listing. sold and rented mark the outcome; deleted removes it from search and feeds while keeping its history. Re-sending the current status changes nothing; any other value is a 400.

curl -X PUT https://api.fondaro.com/properties/29a1e184-237a-40c8-a1fe-624b0bcbb2f4 \  -H "Authorization: Bearer fondaro_pk_abc123" \  -H "Content-Type: application/json" \  -d '{"status": "sold"}'

{  "id": "29a1e184-237a-40c8-a1fe-624b0bcbb2f4",  "referenceNumber": "FDR-7KQ2MX9A",  "status": "sold"}

An ordinary edit never changes the status, and a payload with no real change writes nothing (neither updatedAt nor history moves).

Renew a listing

PUT /properties/:id/renew

Sets expiresAt to two months from now, stamps lastRenewedAt and makes an inactive listing active again. Other statuses are kept. Needs properties:write.

curl -X PUT https://api.fondaro.com/properties/29a1e184-237a-40c8-a1fe-624b0bcbb2f4/renew \  -H "Authorization: Bearer fondaro_pk_abc123"

{  "id": "29a1e184-237a-40c8-a1fe-624b0bcbb2f4",  "status": "active",  "expiresAt": "2026-12-02T10:00:00.000Z",  "lastRenewedAt": "2026-10-02T10:00:00.000Z"}

Automatic renewal. With autoRenewEnabled: true on the listing, the daily expiry check renews an active listing at expiresAt instead of making it inactive, and sends no expiry emails for it. A listing that is not active is not renewed automatically.

List expiring listings

GET /properties/expiring/soon

Your listings that expire within a window, including those set to renew automatically. Needs properties:read.

curl "https://api.fondaro.com/properties/expiring/soon?days=14" \  -H "Authorization: Bearer fondaro_pk_abc123"

[  {    "id": "29a1e184-237a-40c8-a1fe-624b0bcbb2f4",    "referenceNumber": "FDR-7KQ2MX9A",    "status": "active",    "expiresAt": "2026-10-12T10:00:00.000Z",    "autoRenewEnabled": false  }]

Imported listings

A listing brought in from another system carries where it came from:

They are null on listings you created. A re-import updates the imported fields but never the assigned agent, your commission, the lead group, or a status you changed. A listing missing from a later import is not deactivated. See Resales import.

History

Every change writes a history event; clients never write them. Read them with GET /properties/:id/activity?types=change (see Activity and viewings).

{  "id": "307e83ce-6cb1-40da-87e4-81a76399f858",  "propertyListingId": "29a1e184-237a-40c8-a1fe-624b0bcbb2f4",  "actorUserId": "user_2abc123",  "type": "status_changed",  "changes": [{ "field": "status", "from": "active", "to": "sold" }],  "source": "user",  "createdAt": "2026-10-02T15:40:00.000Z"}

Errors