Errors

insufficient_credits

Last updated: October 2026

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


curl "https://api.cardog.app/v2/pricing"

# After the account has available credits:
curl "https://api.cardog.app/v2/vin/2T3R1RFV7MW180266" \
  -H "x-api-key: $CARDOG_API_KEY" \
  -H "Cardog-Version: 2026-10-26"

Was this helpful?