StateSet API Docs

{ "answer": "string", "confidence": 1, "evidence": [], "explanation": null, "metadata": { "facts_used": 1, "query_time_ms": 1, "rules_fired": 1 }, "reasoning_type": "string", "session_id": "string" }

Required scope: read

Query parameters

string

required

Query string to evaluate

string

required

RFC3339 timestamp for historical snapshot

string

Optional strategy override

string

Optional session ID

integer

Optional max depth override

number (float)

Optional confidence threshold override

boolean

Whether to include explanation in response

number (float)

Neural weight for hybrid reasoning

boolean

Whether to include evidence in response

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 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 --request GET \
  --url 'https://api.nsr.stateset.com/api/v1/reason' \
  --header 'X-API-Key: YOUR_API_KEY'

{
  "answer": "string",
  "confidence": 1,
  "evidence": [],
  "explanation": null,
  "metadata": {
    "facts_used": 1,
    "query_time_ms": 1,
    "rules_fired": 1
  },
  "reasoning_type": "string",
  "session_id": "string"
}

​Query parameters

​Response

​Status codes

Query parameters

Response

Status codes