Deletion Protocol

The mandatory endpoint to report properties deleted or removed from the Spot2 selection. Without this endpoint, Spot2 cannot detect delistings and deleted or removed properties will remain published.

---

Endpoint

GET https://your-crm.com/api/v1/spot2/properties/deleted?since=2026-06-29T14:00:00Z

Parameter	Required	Description
since	Yes (except first cycle)	ISO 8601. Returns IDs deleted since this date. Spot2 does not send it on the first cycle.

Authentication

Same as the main properties endpoint.

Response format

{
  "deleted_ids": ["prop-001", "prop-002", "prop-005"],
  "since": "2026-06-29T14:00:00Z",
  "generated_at": "2026-06-30T10:00:00Z"
}

If there are no delistings, you may return an empty set:

{
  "deleted_ids": [],
  "since": null,
  "generated_at": "2026-07-24T15:40:43.143Z"
}

Field	Type	Description
deleted_ids	string[]	external_id of properties deleted or removed from the Spot2 selection. Empty array if no delistings.
since	ISO 8601 or null	Echo of the received parameter, or null when not applicable.
generated_at	ISO 8601 or null	When the response was generated.

You may also respond with 204 No Content; Spot2 interprets it as an empty deleted set.

Retention

Your CRM must retain deletion history for at least 30 days. If since is older than your retention window, return all available deleted IDs.

Frequency

Spot2 queries this endpoint on each scheduled cycle, at the same frequency as the main endpoint.

---

Cycle flow

1. Spot2 sends GET /properties/deleted?since=<last_successful_cycle>.
2. Your API returns the external_ids deleted or removed from Spot2 since that date.
3. Spot2 processes the list and deactivates those properties.
4. If the cycle fails (timeout, 500), Spot2 does not update since. The next cycle retries from the same date — no data is lost.
5. If your API returns "deleted_ids": [], there are no delistings. Spot2 saves the current timestamp as since for the next cycle.

Partial deletion

If a property has both rent and sale, and only one operation is deleted:

• Do not report it in deleted_ids.
• Update the property in the main feed with the corrected modality (e.g., rent_and_sale → sale).
• Spot2 updates the modality without deactivating the property.

---

Timeout and rate limits

Standard operational timeout: up to 300 seconds. Recommended rate limit: at least 60 requests per minute for the Spot2 credential.