StateSet API Docs

{ "nodes": [ { "claim": "string", "confidence": 1, "depends_on": [], "embedding": [], "evidence_type": "Assertion", "id": "string", "source": { "actor": null, "actor_id": null, "metadata": null, "org_id": null }, "timestamp": "2026-07-24T12:00:00Z" } ], "total": 1 }

Required scope: read

Query parameters

string

Claim key to query evidence for

string

Entity ID to query evidence for

string

Free-text search over evidence fields

number (float)

Minimum confidence threshold

number (float)

Minimum cosine similarity for semantic search (0.0..1.0)

string

Natural language query for embedding-based evidence search

string

Explicit query embedding as comma-separated floats

integer

Maximum nodes to return (1..1000)

Response

EvidenceResponse

EvidenceNode[]

required

Show EvidenceNode

string

required

The claim or fact this evidence supports

number (float)

required

Confidence in this evidence

string[]

required

IDs of evidence nodes this depends on

number (float)[]

Optional vector embedding for semantic search.

EvidenceType

required

string

required

Unique node ID

EvidenceSourceMeta

required

Show EvidenceSourceMeta

string

required

Who/what created this evidence

string

API key or session ID

object

required

Free-form metadata

string

Organization

string (date-time)

required

Timestamp when evidence was recorded

integer

required

Status codes

Code	Meaning
`200`	Evidence nodes
`400`	Invalid query parameters
`401`	Unauthorized — missing or invalid credentials
`403`	Forbidden — the key/token lacks the required scope
`429`	Rate limited — see Retry-After / X-RateLimit-Reset

curl --request GET \
  --url 'https://api.nsr.stateset.com/api/v1/evidence' \
  --header 'X-API-Key: YOUR_API_KEY'

{
  "nodes": [
    {
      "claim": "string",
      "confidence": 1,
      "depends_on": [],
      "embedding": [],
      "evidence_type": "Assertion",
      "id": "string",
      "source": {
        "actor": null,
        "actor_id": null,
        "metadata": null,
        "org_id": null
      },
      "timestamp": "2026-07-24T12:00:00Z"
    }
  ],
  "total": 1
}

​Query parameters

​Response

​Status codes

Query parameters

Response

Status codes