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

# Error Codes

> Complete reference for NovaShield API error codes

## Client Errors (400)

| Code             | HTTP | Description                           |
| ---------------- | ---- | ------------------------------------- |
| INVALID\_REQUEST | 400  | Invalid or missing request parameters |

## Rate Limiting (429)

| Code                  | HTTP | Description                                                    |
| --------------------- | ---- | -------------------------------------------------------------- |
| RATE\_LIMIT\_EXCEEDED | 429  | Too many requests (100 per 15min general, 20 per 15min strict) |

## Request Size (413)

| Code                | HTTP | Description                            |
| ------------------- | ---- | -------------------------------------- |
| REQUEST\_TOO\_LARGE | 413  | Request URL or body exceeds size limit |

## Not Found (404)

| Code                 | HTTP | Description          |
| -------------------- | ---- | -------------------- |
| ENDPOINT\_NOT\_FOUND | 404  | Invalid API endpoint |

## Analysis Failures (500)

| Code                       | HTTP | Description                        |
| -------------------------- | ---- | ---------------------------------- |
| ANALYSIS\_FAILED           | 500  | Complete security analysis failed  |
| BUNDLER\_DETECTION\_FAILED | 500  | Coordinated buyer detection failed |
| PHISHING\_CHECK\_FAILED    | 500  | Phishing detection failed          |
| SIMULATION\_FAILED         | 500  | Transaction simulation failed      |

## General (500)

| Code                    | HTTP | Description            |
| ----------------------- | ---- | ---------------------- |
| INTERNAL\_SERVER\_ERROR | 500  | Unhandled server error |

***

## Summary

**Categories:**

* 4xx Client Errors
* 429 Rate Limiting
* 413 Too Large
* 404 Not Found
* 5xx Server Errors (analysis failures + general)

All errors return consistent JSON format:

```json theme={null}
{
  "success": false,
  "error": {
    "code": "ERROR_CODE",
    "message": "Human-readable description"
  }
}
```