Skip to main content
GET
Call this endpoint before creating a search. It returns the account-wide values that determine whether a request can be accepted.

Response fields

string
Machine-readable plan: free, starter, growth, scale, or agency.
string
Subscription status. Paid searches require active or trialing.
integer
Credits assigned to the current plan period.
integer
Credits available for new searches.
Current account ceiling: 300 during a trial, 700 on an active paid subscription, and 0 otherwise.
boolean
Legacy field retained for compatibility with grandfathered accounts.
boolean
Whether this account already received its one 3-day, 300-credit trial.
integer
Jobs currently queued or processing.
integer
Businesses imported across dashboard, API, and MCP searches.
For Pay-on-Find accounts, credits_remaining limits returned contact data rather than the requested business count. Use max_results_per_search as the job-size ceiling.