Error code
insufficient_credits
Replenish credits before retrying. A hard-stop plan has no allowance or prepaid pack balance left.
What happened
The 402 envelope and X-Credits-* headers report the allowance and reset. Failed requests cost zero credits. Paid tiers continue as billed overage; hard-stop tiers must reset, buy a pack, or upgrade.
Do this next
Fetch the current rate card, then buy credits or upgrade through the signed-in account flow. Retry the original metered request only after credit capacity is available.
Corrected request
bash
curl "https://api.cardog.app/v2/pricing"
# After the account has available credits:
curl "https://api.cardog.app/v2/vin/1HGCM82633A123456" \
-H "x-api-key: $CARDOG_API_KEY"