Skip to main content
Use GET /usage to check account-level API state.
The response includes:
  • Current plan
  • Monthly contact credit total, used, and remaining
  • Trial state, if the authenticated account is in a paid-plan trial
  • Paid-plan contact credit total, so trial users can distinguish the 250-credit trial cap from the normal paid limit
  • Request quota state
  • Search-row quota state
  • Current billing or usage period
  • Rate-limit metadata
Trial users receive 250 contact credits during the trial. Paid Pro includes 1,000 monthly contact credits. When a trial is active, contact_credits.total shows the current trial cap and contact_credits.paid_plan_total shows the paid-plan limit. If ending the trial would unlock paid credits immediately, the response includes a billing object with an end_trial_to_unlock_pro_credits action and billing-page URL. This endpoint does not spend contact credits.