Troubleshooting

Each entry names the message you will see (in the chat, in a tool, or in the dashboard), what it means, and what to do.

What you'll need

Access to your dashboard. Most fixes take one minute there.

1. "API key not valid" or "Unauthorized: invalid API key"

The key the tool sends does not match any key in your account. Open API Keys in the dashboard and check the key still exists and is enabled. Then re-paste it into the tool with no spaces before or after. If in doubt, create a new key and use that.

2. "Insufficient Balance" or "insufficient credits"

Your credits are used up (or a Halfbill Code allowance is exhausted with overflow off). Click Top Up Credits in the dashboard. For a Code plan, enable pay-as-you-go overflow or wait for the monthly renewal. See Add credits.

3. "Model not found" or "Model access denied"

The model id has a typo, or your key or plan is not allowed to use it. Copy the exact id from halfbill.uk/models (for example claude-sonnet-5, with no vendor prefix). Chat Basic excludes the most expensive models; upgrade or pick another model.

4. "Rate limit exceeded"

You sent too many requests in one minute. Wait a moment and try again. If a tool hits this often, email support@halfbill.uk and describe how you use it.

5. "API key reached its usage limit"

That key has a spend limit and has reached it. Your balance may be fine. Open API Keys, find the key, and raise or remove the limit under Limits.

6. "API key has expired" or "API key is not active"

The key had an expiration date, or it was disabled. In API Keys, set a new expiration or turn the key back on.

7. Claude Code or Cursor still uses the vendor, not Halfbill

The base URL was not saved, or the tool was not restarted. Check the settings file (Claude Code) or Override OpenAI Base URL (Cursor), then fully quit and reopen the tool. Verify by looking for the request under Activity in your dashboard.

8. My invoice has no company name or VAT number

Invoices are generated at payment time from your billing details. Enter company name, address, and VAT number under Billing → Billing details before your next purchase. For a correction to a past invoice, email support@halfbill.uk with the invoice number. Prices exclude VAT; VAT is added at checkout for EU customers.

9. I want to delete my account

Click your name at the bottom left of the dashboard → Account → Delete Account. This is permanent: your keys stop working, active subscriptions are cancelled, and organizations where you are the last member are closed. Billing records are kept as long as tax law requires.