curl "https://www.mapsdata.io/api/v1/account" \
-H "x-api-key: md_live_your_key"
{
"plan_code": "starter",
"plan_name": "Starter",
"status": "active",
"billing_interval": "monthly",
"credits_allowance": 10000,
"credits_remaining": 7420,
"max_results_per_search": 700,
"free_search_used": false,
"stripe_customer": true,
"current_period_end": "2026-10-31T23:59:59Z",
"cancel_at_period_end": false,
"pause_collection": false,
"pause_resumes_at": null,
"cancellation_coupon_applied": false,
"searches_created": 18,
"active_searches": 1,
"leads_found": 2480
}
Endpoints
Get account
Read the current plan, subscription status, search allowance, and remaining credits.
GET
/
account
curl "https://www.mapsdata.io/api/v1/account" \
-H "x-api-key: md_live_your_key"
{
"plan_code": "starter",
"plan_name": "Starter",
"status": "active",
"billing_interval": "monthly",
"credits_allowance": 10000,
"credits_remaining": 7420,
"max_results_per_search": 700,
"free_search_used": false,
"stripe_customer": true,
"current_period_end": "2026-10-31T23:59:59Z",
"cancel_at_period_end": false,
"pause_collection": false,
"pause_resumes_at": null,
"cancellation_coupon_applied": false,
"searches_created": 18,
"active_searches": 1,
"leads_found": 2480
}
Call this endpoint before creating a search. It returns the account-wide values that determine whether a request can be accepted.
curl "https://www.mapsdata.io/api/v1/account" \
-H "x-api-key: md_live_your_key"
{
"plan_code": "starter",
"plan_name": "Starter",
"status": "active",
"billing_interval": "monthly",
"credits_allowance": 10000,
"credits_remaining": 7420,
"max_results_per_search": 700,
"free_search_used": false,
"stripe_customer": true,
"current_period_end": "2026-10-31T23:59:59Z",
"cancel_at_period_end": false,
"pause_collection": false,
"pause_resumes_at": null,
"cancellation_coupon_applied": false,
"searches_created": 18,
"active_searches": 1,
"leads_found": 2480
}
Response fields
string
Machine-readable plan:
free, starter, growth, or scale.string
Subscription status. Paid searches require
active or trialing.integer
Credits assigned to the current plan period.
integer
Credits available for new searches.
integer
Current account ceiling:
100 on free, 700 on an active paid plan, and 0 when a paid subscription is inactive.boolean
Whether the account already used its one free search.
integer
Jobs currently queued or processing.
integer
Businesses imported across dashboard and API searches.
Use
Math.min(max_results_per_search, credits_remaining) as the largest affordable maxResults. A free account is still limited by whether its free search was already used.