---
title: "Bounded candidate search behind the claim row's Link evidence picker. Returns up to 25 non-excluded evidence items from the intent's product, each with its trust tier and a short content excerpt, optionally excluding items already anchored to one claim. Never returns the product's full inventory."
method: GET
path: "/api/v1/intents/{id}/evidence/candidates"
tags: ["evidence"]
---

# Bounded candidate search behind the claim row's Link evidence picker. Returns up to 25 non-excluded evidence items from the intent's product, each with its trust tier and a short content excerpt, optionally excluding items already anchored to one claim. Never returns the product's full inventory.

`GET /api/v1/intents/{id}/evidence/candidates`

Claim Trust Loop closeout (Sep 2026). Amendment 4 of the evidence trust contract forbids resolving claim backing from a browser-side copy of the product inventory, so the IntentSpec picker calls this route instead of listing all product evidence. Visibility is decided server-side: the intent must live in the caller's workspace and candidates are restricted to the intent's product; archived and dismissed rows never appear. Anchoring is not review: tier is reported so the picker can show what an item is, and turning an observed signal into backing remains the session-only atomic review action.

## Path parameters

- `id` string, required

## Query parameters

- `q` string
- `limit` number
- `anchorKey` string
- `workspace_id` string

## Response `200`

Candidates with trust tiers. tier is one of backing, unreviewed, assumption; excluded items are never returned.

- object

## Other responses

- `400` — Invalid query (zod)
- `401` — Missing/invalid API key or session
- `403` — Key lacks read scope
- `404` — Intent not found in this workspace
- `409` — INTENT_HAS_NO_PRODUCT: the intent has no product, and candidates require a product scope
- `429` — general rate limit exceeded (300/h per user)
- `500` — Internal server error

## Changes

- **2026-09-04** `35441fda7ae7` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/pathmode/apis/pathmode-api/changes/api/v1/intents/:id/evidence/candidates/get.md)

---

[API](https://skmtc.dev/pathmode/apis/pathmode-api.md) · [All operations](https://skmtc.dev/pathmode/apis/pathmode-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pathmode/apis/pathmode-api/revisions/35441fda7ae7?raw)