Get evidence

Attributed quotes for a scope — a signal, one or more themes, a study, or specific source items. Optionally include counter-evidence.

GET/v1/evidence

Example

curl -X GET "https://example.com/v1/evidence" \  -H "Authorization: Bearer $ASKENGINE_API_KEY"

Query Parameters

signalId?string

Scope to a signal's evidence.

themeIds?string

Comma-separated theme ids (max 50).

studyId?string

Scope to a study.

sourceItemIds?string

Comma-separated source-item ids (max 50).

includeCounterEvidence?boolean

Include counter-evidence in the packet.

maxItems?integer

Cap the number of evidence items returned.

Default50Range1-200

Response

{  "data": {    "items": [      {        "evidenceId": "ev_001",        "kind": "evidence",        "quote": "I gave up twice before I figured out where to add my API key.",        "relevance": 0.91,        "themeId": "thm_setup",        "themeLabel": "Setup friction",        "studyId": "std_789",        "studyName": "Onboarding interviews Q4",        "sourceItemId": "src_a1",        "participantId": "par_9",        "participantName": "Ada L.",        "timeInCallSecs": 412,        "capturedAt": 1764453600000      }    ],    "scope": {      "themeIds": [        "thm_setup"      ],      "studyIds": [        "std_789"      ]    },    "distinctParticipants": 6  }}