> ## Documentation Index
> Fetch the complete documentation index at: https://storeinspect.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Usage

> Check plan access, request quotas, search-row quotas, and contact credits.

Use `GET /usage` to check account-level API state.

```bash theme={null}
curl https://storeinspect.com/api/v1/usage \
  -H "Authorization: Bearer $STOREINSPECT_API_KEY"
```

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.