StateSet API Docs

curl --request POST \
  --url 'https://api.nsr.stateset.com/api/v1/reason' \
  --header 'X-API-Key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "as_of_timestamp": "string",
  "include_evidence": true,
  "ir": null,
  "options": {
    "confidence_threshold": 1,
    "include_explanation": true,
    "max_depth": 1,
    "neural_weight": 1
  },
  "query": "string",
  "session_id": "string",
  "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": 1,
  "evidence": [],
  "explanation": null,
  "metadata": {
    "facts_used": 1,
    "query_time_ms": 1,
    "rules_fired": 1
  },
  "reasoning_type": "string",
  "session_id": "string"
}

POST

api

reason

curl --request POST \
  --url 'https://api.nsr.stateset.com/api/v1/reason' \
  --header 'X-API-Key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "as_of_timestamp": "string",
  "include_evidence": true,
  "ir": null,
  "options": {
    "confidence_threshold": 1,
    "include_explanation": true,
    "max_depth": 1,
    "neural_weight": 1
  },
  "query": "string",
  "session_id": "string",
  "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": 1,
  "evidence": [],
  "explanation": null,
  "metadata": {
    "facts_used": 1,
    "query_time_ms": 1,
    "rules_fired": 1
  },
  "reasoning_type": "string",
  "session_id": "string"
}

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

query: The question or goal to reason about
strategy: Optional reasoning strategy (SymbolicFirst, NeuralFirst, Hybrid, Ensemble, Cascading)
session_id: Optional session ID for context continuity
options: Optional configuration overrides (max_depth, confidence_threshold, neural_weight) Response Returns a ReasonResponse containing:
answer: The reasoning result
confidence: Confidence score (0.0-1.0)
explanation: Human-readable explanation of the reasoning path
session_id: Session ID for follow-up queries Errors
400 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 '&#123;'query': 'What are the properties of entity X?', 'strategy': 'hybrid'&#125;'

Execute a reasoning query. Required scope: write

Request body

ReasonRequest

string

Optional RFC3339 timestamp for time-travel reasoning against a historical KB snapshot

boolean

Include evidence/citation objects in the response

object

Optional pre-compiled IR. Provide exactly one of query or ir.

object

string

The query to reason about

string

Session ID for context persistence

object

Response

ReasonResponse

string

The answer to the query

number (float)

required

Confidence score (0.0 to 1.0)

any[]

Optional evidence/citation objects supporting the answer

object

Detailed explanation of reasoning steps

ResponseMetadata

required

Show ResponseMetadata

integer

required

Number of facts used in reasoning

integer (int64)

required

Query processing time in milliseconds

integer

required

Number of rules fired during inference

string

required

Type of reasoning used (symbolic, neural, hybrid)

string

Session ID for follow-up queries

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: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "as_of_timestamp": "string",
  "include_evidence": true,
  "ir": null,
  "options": {
    "confidence_threshold": 1,
    "include_explanation": true,
    "max_depth": 1,
    "neural_weight": 1
  },
  "query": "string",
  "session_id": "string",
  "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": 1,
  "evidence": [],
  "explanation": null,
  "metadata": {
    "facts_used": 1,
    "query_time_ms": 1,
    "rules_fired": 1
  },
  "reasoning_type": "string",
  "session_id": "string"
}

​Request body

​Response

​Status codes

Request body

Response

Status codes