curl --request POST \
--url 'https://api.nsr.stateset.com/api/v1/reason' \
--header "X-API-Key: $STATESET_NSR_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"as_of_timestamp": "2026-08-31T14:22:05Z",
"include_evidence": true,
"ir": null,
"options": {
"confidence_threshold": 7.5,
"include_explanation": true,
"max_depth": 1,
"neural_weight": 1.2
},
"query": "string",
"session_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"strategy": {
"0": "s",
"1": "y",
"2": "m",
"3": "b",
"4": "o",
"5": "l",
"6": "i",
"7": "c",
"8": "_",
"9": "f",
"10": "i",
"11": "r",
"12": "s",
"13": "t"
}
}'
{
"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"
}
Execute a reasoning query using the NSR engine.
This is the primary endpoint for performing neural-symbolic reasoning…
POST
/
api
/
v1
/
reason
curl --request POST \
--url 'https://api.nsr.stateset.com/api/v1/reason' \
--header "X-API-Key: $STATESET_NSR_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"as_of_timestamp": "2026-08-31T14:22:05Z",
"include_evidence": true,
"ir": null,
"options": {
"confidence_threshold": 7.5,
"include_explanation": true,
"max_depth": 1,
"neural_weight": 1.2
},
"query": "string",
"session_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"strategy": {
"0": "s",
"1": "y",
"2": "m",
"3": "b",
"4": "o",
"5": "l",
"6": "i",
"7": "c",
"8": "_",
"9": "f",
"10": "i",
"11": "r",
"12": "s",
"13": "t"
}
}'
{
"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"
}
This is the primary endpoint for performing neural-symbolic reasoning.
It accepts a query string and optional parameters to control the reasoning
process, including strategy selection and configuration overrides.
Request Body
Execute a reasoning query.
Required scope:
query: The question or goal to reason aboutstrategy: Optional reasoning strategy (SymbolicFirst, NeuralFirst, Hybrid, Ensemble, Cascading)session_id: Optional session ID for context continuityoptions: Optional configuration overrides (max_depth, confidence_threshold, neural_weight) Response Returns aReasonResponsecontaining:answer: The reasoning resultconfidence: Confidence score (0.0-1.0)explanation: Human-readable explanation of the reasoning pathsession_id: Session ID for follow-up queries Errors400 Bad Request: Invalid input (empty query, exceeds max length)500 Internal Server Error: Reasoning engine failure Example Example (curl)
curl -X POST 'https://api.nsr.stateset.com/api/v1/reason' \
-H 'X-API-Key: your-api-key' \
-H 'Content-Type: application/json' \
-d '{'query': 'What are the properties of entity X?', 'strategy': 'hybrid'}'
write
Request body
ReasonRequest
Response
ReasonResponse
Status codes
| Code | Meaning |
|---|---|
200 | Reasoning completed successfully |
400 | Invalid request - empty query or exceeds max length |
401 | Unauthorized — missing or invalid credentials |
403 | Forbidden — the key/token lacks the required scope |
429 | Rate limited — see Retry-After / X-RateLimit-Reset |
500 | Reasoning engine failure |
curl --request POST \
--url 'https://api.nsr.stateset.com/api/v1/reason' \
--header "X-API-Key: $STATESET_NSR_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"as_of_timestamp": "2026-08-31T14:22:05Z",
"include_evidence": true,
"ir": null,
"options": {
"confidence_threshold": 7.5,
"include_explanation": true,
"max_depth": 1,
"neural_weight": 1.2
},
"query": "string",
"session_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"strategy": {
"0": "s",
"1": "y",
"2": "m",
"3": "b",
"4": "o",
"5": "l",
"6": "i",
"7": "c",
"8": "_",
"9": "f",
"10": "i",
"11": "r",
"12": "s",
"13": "t"
}
}'
{
"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"
}
Last modified on August 31, 2026