> ## Documentation Index
> Fetch the complete documentation index at: https://docs.neuralverge.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Errors & Rate Limits

> Error handling, common response codes, retry guidance, and polling recommendations.

# 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`

## Recommended polling interval

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

```json theme={null}
{
  "error": "Invalid parameters"
}
```

The exact error payload can vary by endpoint.