TRIAL_LIMIT_EXCEEDED — Free trial used up
Summary
Section titled “Summary”Free accounts start with 250 credits. Once they’re spent, further coding requests return TRIAL_LIMIT_EXCEEDED instead of charging — you can’t go negative on a free account.
HTTP status
Section titled “HTTP status”402 Payment Required. Standard envelope.
Example response
Section titled “Example response”{ "success": false, "error": { "code": "TRIAL_LIMIT_EXCEEDED", "message": "Free trial credits exhausted. Upgrade to continue.", "request_id": "req_01HXJZK4ABCDEF", "doc_url": "https://docs.surveycoder.io/errors/trial-limit-exceeded" }}Why this happens
Section titled “Why this happens”You’re on the free plan and have used all 250 starter credits.
How to fix it
Section titled “How to fix it”- Open surveycoder.io/pricing and pick a plan.
- The Starter pack ($59) adds 500 credits one-time, no subscription. Pro ($199) adds 2,000. Studio ($399) adds 5,000.
- After purchase, credits land in seconds. Retry the same request.
For evaluation use cases, the free tier on POST /free/code accepts up to 100 responses per call with 3 calls per IP per day — useful for prototyping without any account.
Related
Section titled “Related”- Credits
INSUFFICIENT_CREDITS— paid plans, same UX