Skip to main content
Evidence links are automatically created when evidence uploaded to one obligation matches semantically similar request items on other active obligations. These endpoints let you query and manage those links.
​
method
GET
/api/request-items/{itemId}/evidence-links
Returns all evidence links targeting a specific request item.
​
itemId
string
required
Request item UUID.
​
status
string
Filter by link status. Comma-separated values: auto_applied, confirmed, rejected.
​
data.links
array
Array of evidence link objects. Each includes:
  • id — Link UUID
  • sourceEvidenceId — The evidence attachment being linked
  • sourceItemId — The request item the evidence was uploaded to
  • sourceExaminationId — The source obligation ID
  • targetItemId — The request item being linked to
  • targetExaminationId — The target obligation ID
  • similarity — Cosine similarity score (0.82–1.0)
  • status — auto_applied, confirmed, or rejected
  • createdAt — When the link was created
  • reviewedAt — When the link was confirmed or rejected (null if pending)
  • evidence — Nested evidence attachment details (fileName, fileSize, mimeType)
  • sourceExamination — Nested source obligation details (id, name)
  • sourceItem — Nested source request item details (itemNumber, originalText)
​
method
PATCH
/api/evidence-links/{linkId}
Updates the status of an evidence link. Forward-only transitions from auto_applied.
​
linkId
string
required
Evidence link UUID.
​
status
string
required
New status. One of: confirmed, rejected.
​
data.link
object
The updated evidence link with reviewedAt timestamp set.
Status transitions are forward-only from auto_applied. You cannot change a confirmed link back to auto_applied or vice versa.
​
method
GET
/api/examinations/{examId}/evidence-link-count
Returns the count of pending (auto-applied) evidence links for an obligation. Used for the sidebar badge.
​
examId
string
required
Examination/obligation ID (e.g., EX-2026-001).
​
data.count
number
Number of auto_applied (pending review) evidence links targeting items in this obligation.
​
method
GET
/api/evidence/{evidenceId}/links
Returns all outbound evidence links originating from a specific evidence attachment. Used for the “Also linked to” indicators.
​
evidenceId
string
required
Evidence attachment UUID.
​
data.links
array
Array of outbound link objects. Each includes:
  • id — Link UUID
  • targetItemId — The linked request item
  • targetExaminationId — The target obligation
  • similarity — Match confidence
  • status — auto_applied, confirmed, or rejected
  • targetExamination — Nested obligation details (id, name)
  • targetItem — Nested request item details (itemNumber, originalText)