Create, Read, Update, Delete Properties

Create, retrieve, update, and delete individual property listings. Also includes endpoints for renewing listings and finding properties that are about to expire.

Create a Property

Authentication: Required (API key or JWT)

Creates a new property listing for your organization. A unique reference number in the format HQL-XXXXX is automatically assigned.

Request Body

Required fields:

Optional fields:

Example

curl -X POST https://api.fondaro.com/properties \
  -H "Authorization: Bearer fondaro_pk_abc123" \
  -H "Content-Type: application/json" \
  -d '{
    "listingType": "sale",
    "propertyCategory": "residential",
    "propertyType": "villa",
    "city": "Marbella",
    "countryCode": "ES",
    "currency": "EUR",
    "price": 1250000,
    "bedrooms": 4,
    "bathrooms": 3,
    "livingArea": 320,
    "plotArea": 800,
    "areaUnit": "sqm",
    "hasPool": true,
    "hasSeaView": true,
    "description": "Stunning sea-view villa in Nueva Andalucía with private pool and landscaped garden."
  }'

Response

Returns the full created property object with the generated id and referenceNumber.

Get a Property

Authentication: Required (API key or JWT)

Path Parameters

Query Parameters

Example

curl https://api.fondaro.com/properties/a1b2c3d4-5e6f-7a8b-9c0d-1e2f3a4b5c6d \
  -H "Authorization: Bearer fondaro_pk_abc123"

Errors

Update a Property

Authentication: Required (API key or JWT)

Updates an existing property. Only include the fields you want to change — all fields are optional. The property must belong to your organization.

Request Body

All fields from the create endpoint are available, plus:

Example

curl -X PUT https://api.fondaro.com/properties/a1b2c3d4-5e6f-7a8b-9c0d-1e2f3a4b5c6d \
  -H "Authorization: Bearer fondaro_pk_abc123" \
  -H "Content-Type: application/json" \
  -d '{
    "price": 1150000,
    "status": "active",
    "description": "Price reduced! Stunning sea-view villa in Nueva Andalucía."
  }'

Errors

Delete a Property

Authentication: Required (API key or JWT)

Permanently deletes a property listing. The property must belong to your organization.

Example

curl -X DELETE https://api.fondaro.com/properties/a1b2c3d4-5e6f-7a8b-9c0d-1e2f3a4b5c6d \
  -H "Authorization: Bearer fondaro_pk_abc123"

Response

{
  "success": true
}

Errors

Renew a Property

Authentication: Required (API key or JWT)

Extends the expiration date of a property listing by 2 months. The property must belong to your organization.

Example

curl -X PUT https://api.fondaro.com/properties/a1b2c3d4-5e6f-7a8b-9c0d-1e2f3a4b5c6d/renew \
  -H "Authorization: Bearer fondaro_pk_abc123"

Response

Returns the full updated property object with the new expiresAt date.

Errors

Get Expiring Properties

Authentication: Required (API key or JWT)

Returns properties in your organization that are expiring within a given number of days.

Query Parameters

Example

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

Response

Returns an array of property objects that will expire within the specified timeframe.