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"