Skip to main content
DELETE
/
v2
/
listings
/
{listing_id}
Delete Listing
curl --request DELETE \
  --url https://api.calmyx.com/v2/listings/{listing_id} \
  --header 'Authorization: <authorization>'
{
  "success": true,
  "message": "Listing deleted successfully",
  "new_listing_count": 1249,
  "deletions_used": 15,
  "deletions_max": 20
}

​
Overview

The Delete Listing API removes a specific listing from your active listings by its unique listing_id. This frees up space in your listing quota.
To obtain an API key, register for an account and subscribe to a plan.
Each plan has a permanent deletion limit to prevent abuse. Once you reach your deletion limit, you must upgrade to Enterprise for unlimited deletions. The deletion limit is calculated as 20% of your plan’s maximum listings.

​
Authorization

​
Authorization
string
required
Your API key for authentication

​
Path Parameters

​
listing_id
string
required
The unique identifier of the listing to delete (UUID format)
{
  "success": true,
  "message": "Listing deleted successfully",
  "new_listing_count": 1249,
  "deletions_used": 15,
  "deletions_max": 20
}

​
Response Fields

FieldTypeDescription
successbooleanWhether the deletion was successful
messagestringConfirmation message
new_listing_countnumberUpdated total number of listings after deletion
deletions_usednumberTotal number of deletions used
deletions_maxnumberMaximum deletions allowed on your plan (-1 for unlimited)

​
Deletion Limits by Plan

The deletion limit is 20% of your plan’s maximum listings. This is a permanent limit that does not reset.
PlanMax ListingsDeletion Limit (20% of max)
Trial10020
Insight10,0002,000
Intelligence100,00020,000
EnterpriseUnlimitedUnlimited

​
Use Cases

  • Free up quota: Delete old or unused listings to make room for new ones
  • Data cleanup: Remove listings that are no longer relevant
  • Portfolio management: Maintain an up-to-date list of active locations