Developer
Usage & credits
Each extracted lead costs one credit. Read your current plan, balance, and limits from the usage endpoint.
GET/v1/usage
| Field | Type | Description |
|---|---|---|
| plan | lite | pro | max | null | Current plan. |
| accessStatus | none | trialing | active | Subscription access state. |
| credits.balance | number | Remaining credits. |
| credits.monthlyAllowance | number | Credits granted for the period. |
| rateLimitPerMinute | number | null | Per-minute request limit. |
| resetsAt | string | null | When the current period ends (ISO 8601). |
cURL
curl https://api.mapleads.ai/v1/usage \
-H "Authorization: Bearer mapleads_xxx"Monthly plans grant their credit allowance each month. Annual plans pre-authorize 12× the monthly amount as a single up-front grant for the year. New trials start with a credit allowance so you can test the full flow before paying.