Skip to main content

​
Errors & Rate Limits

This page describes the most common response codes and integration patterns to handle when using the NeuralVerge API.

​
Common status codes

​
400 Bad Request

The request body or parameters are invalid. Typical causes:
  • missing required fields
  • invalid JSON
  • invalid UUID, URL, email, or phone format
  • unsupported option values

​
401 Unauthorized

Authentication failed. Typical causes:
  • missing Authorization header
  • invalid bearer token format
  • expired or invalid token

​
402 Payment Required

The operation cannot proceed because of plan or usage limits. Typical causes:
  • points limit exceeded
  • inactive subscription
  • expired subscription

​
404 Not Found

The requested resource does not exist or is not available to the current user. Typical causes:
  • invalid session_id
  • missing agent
  • inaccessible resource

​
500 Internal Error

An internal processing error occurred. Typical causes:
  • upstream provider issues
  • temporary service failure
  • unexpected backend processing error

​
Polling asynchronous jobs

For async endpoints:
  1. Call the run endpoint
  2. Save the returned session_id
  3. Poll Get Session Status
  4. Stop polling when the status becomes complete or failed
A practical polling strategy is:
  • poll every 2 to 5 seconds
  • set a reasonable overall timeout
  • log the last known status
  • handle temporary failures gracefully

​
Retry guidance

Retries are useful for:
  • temporary network errors
  • intermittent 500 responses
  • short-lived upstream issues
Retries usually do not help for:
  • 400
  • 401
  • 402
  • 404

​
Example error

The exact error payload can vary by endpoint.