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

# Batch validate responses using NSR-L rules + text signals.

> **Required scope:** write

**Required scope:** `write`

### Request body

`NSRValidateBatchRequest`

**cases** `NSRValidateBatchItem[]` *required*

Items to validate.

**include\_neural\_signals** `boolean`

Include NSR Machine neural signals in the response.

**max\_ngram** `integer`

Max n-gram length used for contains\_text assertions.

**max\_phrases** `integer`

Cap on total phrases asserted per text.

**persist** `boolean`

Persist validation runs for history/auditing.

### Response

`NSRValidateBatchResponse`

**invalid** `integer` *required*

**results** `NSRValidateBatchItemResult[]` *required*

**NSRValidateBatchItemResult**

**case\_id** `string`

**index** `integer` *required*

**inquiry** `string` *required*

**response** `string` *required*

**result** `NSRValidateResponse` *required*

**NSRValidateResponse**

**escalations** `string[]` *required*

Escalation topics detected.

**execution\_time\_ms** `integer (int64)` *required*

Execution time in milliseconds.

**missing\_links** `string[]` *required*

Missing required links.

**neural** `object`

**program\_version\_id** `string`

Optional NSR-L program version id used for this validation.

**response\_invalid** `boolean` *required*

Response is explicitly invalid (response\_invalid/1).

**run\_id** `string`

Optional persisted run id when stored.

**topics** `string[]` *required*

Topics detected in the inquiry.

**valid** `boolean` *required*

Overall validity (no violations/missing links/escalations and not response\_invalid).

**violations** `string[]` *required*

Prohibited phrases detected.

**total** `integer` *required*

**valid** `integer` *required*

### Status codes

| Code | Meaning |
| - | - |
| `200` | Batch validation result |
| `400` | Invalid request |
| `401` | Unauthorized — missing or invalid credentials |
| `403` | Forbidden — the key/token lacks the required scope |
| `429` | Rate limited — see Retry-After / X-RateLimit-Reset |

```bash cURL theme={null}
curl --request POST \
  --url 'https://api.nsr.stateset.com/api/v1/nsr/validate/batch' \
  --header "X-API-Key: $STATESET_NSR_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "cases": [
    {
      "case_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "inquiry": "string",
      "response": "string"
    }
  ],
  "include_neural_signals": true,
  "max_ngram": 1,
  "max_phrases": 1,
  "persist": true
}'
```

```json 200 theme={null}
{
  "invalid": 1,
  "results": [
    {
      "case_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "index": 1,
      "inquiry": "string",
      "response": "string",
      "result": {
        "escalations": null,
        "execution_time_ms": null,
        "missing_links": null,
        "neural": null,
        "program_version_id": null,
        "response_invalid": null,
        "run_id": null,
        "topics": null,
        "valid": null,
        "violations": null
      }
    }
  ],
  "total": 102,
  "valid": 1
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.