StateSet API Docs

curl --request POST \ --url 'https://api.nsr.stateset.com/api/v1/jobs/batch-infer' \ --header 'X-API-Key: YOUR_API_KEY' \ --header 'Content-Type: application/json' \ --data '{ "include_explanation": true, "inputs": [ "string" ], "max_depth": 1 }'

Submits a batch of queries for asynchronous processing. Returns immediately with a job ID that can be used to track progress and retrieve results. Use Cases

Processing large datasets that exceed single-request timeouts
Running inference on multiple queries in parallel
Background processing without blocking the client Example

curl -X POST 'https://api.nsr.stateset.com/api/v1/jobs/batch-infer' \
-H 'X-API-Key: your-api-key' \
-H 'Content-Type: application/json' \
-d '&#123;'inputs': ['query 1', 'query 2', 'query 3'], 'max_depth': 5&#125;'

Required scope: write

Request body

BatchInferRequest

boolean

Include explanations

string[]

required

List of input queries

integer

Maximum reasoning depth

Response

JobSubmitResponse

string

required

Job identifier for tracking

JobStatus

required

integer

required

Estimated items to process

Status codes

Code	Meaning
`202`	Job submitted successfully
`400`	Invalid request - no inputs or too many items
`401`	Unauthorized — missing or invalid credentials
`403`	Forbidden — the key/token lacks the required scope
`429`	Rate limited — see Retry-After / X-RateLimit-Reset
`503`	Service unavailable - job queue full

curl --request POST \
  --url 'https://api.nsr.stateset.com/api/v1/jobs/batch-infer' \
  --header 'X-API-Key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "include_explanation": true,
  "inputs": [
    "string"
  ],
  "max_depth": 1
}'

{
  "job_id": "string",
  "status": "pending",
  "total_items": 1
}

​Request body

​Response

​Status codes

Request body

Response

Status codes