Reason at time handler

Required scope: read

GET /api/v1/reason

cURL

curl --request GET \
  --url 'https://api.nsr.stateset.com/api/v1/reason' \
  --header "X-API-Key: $STATESET_NSR_API_KEY"

200

{
  "answer": "string",
  "confidence": 7.5,
  "evidence": [],
  "explanation": null,
  "metadata": {
    "facts_used": 1,
    "query_time_ms": 250,
    "rules_fired": 1
  },
  "reasoning_type": "string",
  "session_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}

Required scope: read

Query parameters

query · string · required

Query string to evaluate

as_of_timestamp · string · required

RFC3339 timestamp for historical snapshot

strategy · string

Optional strategy override

session_id · string

Optional session ID

max_depth · integer

Optional max depth override

confidence_threshold · number (float)

Optional confidence threshold override

include_explanation · boolean

Whether to include explanation in response

neural_weight · number (float)

Neural weight for hybrid reasoning

include_evidence · boolean

Whether to include evidence in response

Response

ReasonResponse

answer · string

The answer to the query

confidence · number (float) · required

Confidence score (0.0 to 1.0)

evidence · any[]

Optional evidence/citation objects supporting the answer

explanation · object

Detailed explanation of reasoning steps

metadata · ResponseMetadata · required

Show ResponseMetadata

facts_used · integer · required

Number of facts used in reasoning

query_time_ms · integer (int64) · required

Query processing time in milliseconds

rules_fired · integer · required

Number of rules fired during inference

reasoning_type · string · required

Type of reasoning used (symbolic, neural, hybrid)

session_id · string

Session ID for follow-up queries

Status codes

Code	Meaning
200	Reasoning completed successfully
400	Invalid query parameters
401	Unauthorized — missing or invalid credentials
403	Forbidden — the key/token lacks the required scope
404	Session not found
429	Rate limited — see Retry-After / X-RateLimit-Reset
500	Reasoning engine failure

cURL

curl --request GET \
  --url 'https://api.nsr.stateset.com/api/v1/reason' \
  --header "X-API-Key: $STATESET_NSR_API_KEY"

200

{
  "answer": "string",
  "confidence": 7.5,
  "evidence": [],
  "explanation": null,
  "metadata": {
    "facts_used": 1,
    "query_time_ms": 250,
    "rules_fired": 1
  },
  "reasoning_type": "string",
  "session_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}