Query evidence by claim or entity

Required scope: read

GET /api/v1/evidence

cURL

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

200

{
  "nodes": [
    {
      "claim": "string",
      "confidence": 7.5,
      "depends_on": [],
      "embedding": [],
      "evidence_type": "Assertion",
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "source": {
        "actor": null,
        "actor_id": null,
        "metadata": null,
        "org_id": null
      },
      "timestamp": "2026-08-31T14:22:05Z"
    }
  ],
  "total": 102
}

Required scope: read

Query parameters

claim · string

Claim key to query evidence for

entity_id · string

Entity ID to query evidence for

q · string

Free-text search over evidence fields

min_confidence · number (float)

Minimum confidence threshold

min_similarity · number (float)

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

embedding_query · string

Natural language query for embedding-based evidence search

query_embedding · string

Explicit query embedding as comma-separated floats

limit · integer

Maximum nodes to return (1..1000)

Response

EvidenceResponse

nodes · EvidenceNode[] · required

Show EvidenceNode

claim · string · required

The claim or fact this evidence supports

confidence · number (float) · required

Confidence in this evidence

depends_on · string[] · required

IDs of evidence nodes this depends on

embedding · number (float)[]

Optional vector embedding for semantic search.

evidence_type · EvidenceType · required

id · string · required

Unique node ID

source · EvidenceSourceMeta · required

Show EvidenceSourceMeta

actor · string · required

Who/what created this evidence

actor_id · string

API key or session ID

metadata · object · required

Free-form metadata

org_id · string

Organization

timestamp · string (date-time) · required

Timestamp when evidence was recorded

total · 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

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

200

{
  "nodes": [
    {
      "claim": "string",
      "confidence": 7.5,
      "depends_on": [],
      "embedding": [],
      "evidence_type": "Assertion",
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "source": {
        "actor": null,
        "actor_id": null,
        "metadata": null,
        "org_id": null
      },
      "timestamp": "2026-08-31T14:22:05Z"
    }
  ],
  "total": 102
}