Skip to content
Survey Coder Pro Survey Coder Pro

INTERNAL_ERROR — Unhandled server error

Summary

Section titled “Summary”

The API hit an unhandled error. This is our fault, not yours. The request_id lets us locate the exact stack trace in seconds.

HTTP status

Section titled “HTTP status”

500 Internal Server Error. Standard envelope.

Example response

Section titled “Example response”
{
  "success": false,
  "error": {
    "code": "INTERNAL_ERROR",
    "message": "An unexpected error occurred. Please contact support with the request_id.",
    "request_id": "req_01HXJZK4ABCDEF",
    "doc_url": "https://docs.surveycoder.io/errors/internal-error"
  }
}

Why this happens

Section titled “Why this happens”

A code path we didn’t anticipate. Could be a new edge case, a recent deploy regression, or a downstream provider behaving oddly.

How to fix it

Section titled “How to fix it”
  1. Retry once with backoff. Many of these are transient.
  2. If the retry also fails with INTERNAL_ERROR, email support@surveycoder.io and include:
    • The request_id from the response.
    • The full endpoint URL and HTTP method.
    • A redacted version of the request body (strip PII, keep shape).
    • The timestamp from when you got the error.
  3. We respond on internal errors in business hours under 4 hours, and out of hours under 24 hours.
Section titled “Related”