Skip to main content

Get contact quota usage

GET 

/api/v1/partner-gateway/subscription/contacts

Returns the contact storage quota for your account, broken down into plan limit, extra limit, total limit, used count, and remaining capacity. The planLimit is the number of contacts included in your subscription plan. The extraLimit is any additional contact capacity you have purchased on top of your plan. The totalLimit is the sum of both. The used field indicates how many contacts are currently stored in your account, and remaining is the number of new contacts you can still add before reaching your quota. Monitor this endpoint before performing bulk contact imports to ensure you have sufficient capacity. If remaining reaches zero, attempts to create new contacts will be rejected. To increase your quota, upgrade your subscription plan or purchase additional contact capacity through the billing dashboard. Returns 401 if the API key is missing or invalid. Returns 404 if no active subscription exists for your account. Returns 502 if the upstream subscription service is temporarily unavailable.

Responses

Contact quota retrieved successfully