Validate a response using NSR-L rules + text signals.

Required scope: write

POST /api/v1/nsr/validate

cURL

curl --request POST \
  --url 'https://api.nsr.stateset.com/api/v1/nsr/validate' \
  --header "X-API-Key: $STATESET_NSR_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "include_neural_signals": false,
  "inquiry": "Can I return my order?",
  "max_ngram": 6,
  "max_phrases": 2000,
  "response": "Hi, I'm Dottie. You can return within 30 days."
}'

200

{
  "escalations": [
    "string"
  ],
  "execution_time_ms": 250,
  "missing_links": [
    "string"
  ],
  "neural": {
    "confidence": 7.5,
    "interpreted_confidence": 7.5,
    "interpreted_output": {
      "type": "null"
    },
    "output": {
      "type": "null"
    },
    "symbols": [
      1
    ]
  },
  "program_version_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "response_invalid": true,
  "run_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "topics": [
    "string"
  ],
  "valid": true,
  "violations": [
    "string"
  ]
}

Required scope: write

Request body

NSRValidateRequest

case_id · string

Optional validation case id (used when replaying test cases).

include_neural_signals · boolean

Include NSR Machine neural signals in the response.

inquiry · string · required

Customer inquiry text.

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 this validation run for history/auditing.

response · string · required

Draft response to validate.

Response

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

Show neural

confidence · number (double) · required

Inference confidence.

interpreted_confidence · number (double)

Interpreted class confidence (if any).

interpreted_output · object

Show interpreted_output

type · string · required

output · object

Show output

type · string · required

symbols · integer (int64)[] · required

Symbol sequence from the NSR Machine.

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.

Status codes

Code	Meaning
200	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

cURL

curl --request POST \
  --url 'https://api.nsr.stateset.com/api/v1/nsr/validate' \
  --header "X-API-Key: $STATESET_NSR_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "include_neural_signals": false,
  "inquiry": "Can I return my order?",
  "max_ngram": 6,
  "max_phrases": 2000,
  "response": "Hi, I'm Dottie. You can return within 30 days."
}'

200

{
  "escalations": [
    "string"
  ],
  "execution_time_ms": 250,
  "missing_links": [
    "string"
  ],
  "neural": {
    "confidence": 7.5,
    "interpreted_confidence": 7.5,
    "interpreted_output": {
      "type": "null"
    },
    "output": {
      "type": "null"
    },
    "symbols": [
      1
    ]
  },
  "program_version_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "response_invalid": true,
  "run_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "topics": [
    "string"
  ],
  "valid": true,
  "violations": [
    "string"
  ]
}