Skip to main content
Review saved findings for one Lead, including earlier results. Each finding includes its own available evidence and assessment. Use the Lead id returned by Leads in the URL. Results are ordered by when the finding was saved, newest first. Leave the date filter unset to include earlier findings, or narrow results by signal type, Sheet, and date.
The people, hiring events, and assessments in this response are illustrative.
The example shows a qualified Lead whose individual hiring finding has qualification: null and ai_score: null. The Lead assessment and the finding assessment are separate; the history endpoint preserves the finding’s own saved values.

Path and body fields

Send {} to request the first page without filters. Omitting found_at includes all retained history; there is no implicit recent-date window. Historical records already stored in Plyne are readable without rerunning a Signal Agent.

What history contains

History uses the same saved signal findings as the portal. It includes qualified, unqualified, and unclear findings. The qualification and ai_score describe the saved finding, rather than replacing it with today’s lead decision. ai_score is null if no score was calculated. Imports and aggregate qualification decision cards are excluded from signal history. Deleted records, hidden source Sheets, and disliked entities are excluded. Results are scoped to the workspace that owns the API key. found_at is when Plyne saved the signal occurrence and is used for filtering and ordering. observed_at, when available, is the source evidence’s observation time; otherwise it is null. These timestamps can differ. references contains the available source links. History is a sequence of retained signal findings, not an audit log of every agent check or every historical version of an updated finding. If repeat checks were combined into an existing occurrence, they remain one entry.

Pagination

Use cursor.next as cursor.after to request another page. Keep the same Lead, filters, and workspace. See Pagination and Filters for page limits and cursor behavior.

Findings behind a decision

Use evaluation_id to read findings linked to one saved evaluation. This preserves the portal’s decision-to-finding relationship. To browse the evaluations themselves, use Lead evaluations. A finding keeps its own assessment. An evaluation’s qualification is never substituted for the finding’s qualification. When continuing an embedded findings_cursor, keep the evaluation ID fixed and leave other filters unset. Without evaluation_id, this endpoint returns all visible saved findings for the record.