Skip to content
Survey Coder Pro Survey Coder Pro

NEGATIVE_BALANCE — Negative-allowed plan hit its floor

Summary

Section titled “Summary”

Enterprise plans can be configured to allow temporary negative balances — useful when you need to keep coding while paperwork catches up. When the balance hits the configured floor (e.g. -10,000 credits), further requests fail with NEGATIVE_BALANCE.

HTTP status

Section titled “HTTP status”

402 Payment Required. Standard envelope.

Example response

Section titled “Example response”
{
  "success": false,
  "error": {
    "code": "NEGATIVE_BALANCE",
    "message": "Balance is -10,000 credits and has reached the configured floor.",
    "request_id": "req_01HXJZK4ABCDEF",
    "doc_url": "https://docs.surveycoder.io/errors/negative-balance"
  }
}

Why this happens

Section titled “Why this happens”
  • An overrun pushed an enterprise account past its negative-balance allowance.
  • The floor was reduced after recent usage already exceeded it.

How to fix it

Section titled “How to fix it”
  1. Email support@surveycoder.io — enterprise customers have a named contact who can either top up the balance manually or raise the negative-balance floor.
  2. For non-blocking ops in the meantime, you can still call read endpoints like GET /v1/usage and GET /v1/jobs/{id} — only coding-charging endpoints are blocked.
Section titled “Related”