Skip to main content
GET
/
v2
/
listings
/
stats
Get Listings Statistics
curl --request GET \
  --url https://api.calmyx.com/v2/listings/stats \
  --header 'Authorization: <authorization>'
{
  "success": true,
  "total_listings": 1250,
  "max_listings": 10000,
  "listings_today": 45,
  "listings_this_month": 320,
  "is_at_limit": false,
  "remaining": 8750,
  "deletions_count": 15,
  "deletions_max": 2000,
  "deletions_remaining": 1985,
  "is_at_churn_limit": false
}

​
Overview

The Get Listings Statistics API returns information about your active listing usage, including current count, limits, deletion/churn tracking, and recent activity. Use this endpoint to monitor your listing quota and plan accordingly.
To obtain an API key, register for an account and subscribe to a plan.

​
Authorization

​
Authorization
string
required
Your API key for authentication
{
  "success": true,
  "total_listings": 1250,
  "max_listings": 10000,
  "listings_today": 45,
  "listings_this_month": 320,
  "is_at_limit": false,
  "remaining": 8750,
  "deletions_count": 15,
  "deletions_max": 2000,
  "deletions_remaining": 1985,
  "is_at_churn_limit": false
}

​
Response Fields

FieldTypeDescription
successbooleanWhether the request was successful
total_listingsnumberTotal number of active listings
max_listingsnumberMaximum listings allowed by your plan (-1 for unlimited)
listings_todaynumberNumber of new listings added today
listings_this_monthnumberNumber of new listings added this month
is_at_limitbooleanWhether you have reached your listing limit
remainingnumberNumber of listings remaining in your quota (-1 for unlimited)
deletions_countnumberTotal number of listings deleted
deletions_maxnumberMaximum deletions allowed on your plan (-1 for unlimited)
deletions_remainingnumberNumber of deletions remaining (-1 for unlimited)
is_at_churn_limitbooleanWhether you have reached your deletion limit

​
Plan Limits

The deletion limit is 20% of your plan’s maximum listings. This is a permanent limit that does not reset.
PlanActive Listings LimitDeletion Limit (20% of max)
Trial10020
Insight10,0002,000
Intelligence100,00020,000
EnterpriseUnlimitedUnlimited
The deletion limit prevents users from infinitely cycling through listings without upgrading. Upgrade to Enterprise for unlimited deletions.

​
Use Cases

  • Usage monitoring: Track how many listings you’ve used vs your limit
  • Capacity planning: Determine if you need to upgrade or manage listings
  • Dashboard display: Show real-time usage statistics in your application
  • Churn monitoring: Track your deletion usage to avoid hitting the limit