curl --request POST \
--url 'https://api.plyne.ai/v1/accounts/co_example_01/signals/search' \
--header 'Authorization: Bearer plyne_...' \
--header 'Content-Type: application/json' \
--data '{
"cursor": {
"limit": 50
}
}'
{
"data": [
{
"id": "sig_example_01",
"type": "hiring_signals",
"name": "Hiring Activity",
"summary": "Stripe has an open Senior Backend Engineer role in this example.",
"reason": "",
"found_at": "2026-11-16T09:42:14.086180Z",
"observed_at": "2026-11-16T09:42:14.086180Z",
"source_sheet": {
"id": "sh_example_01",
"name": "Cloud infrastructure hiring"
},
"signal_agent_id": "ag_example_01",
"qualification": {
"status": "qualified",
"reason": "Stripe has an open Senior Backend Engineer role in this example.",
"reasoning": "A backend engineering opening in the US matches the tracked hiring criteria. Hiring provides relevant context, but the available evidence supports a medium fit score.",
"references": [
{
"type": "evidence",
"label": "Senior Backend Engineer",
"url": "https://example.com/jobs/senior-backend-engineer"
}
]
},
"ai_score": {
"value": 64,
"fit": "medium",
"reasoning": "A backend engineering opening in the US matches the tracked hiring criteria. Hiring provides relevant context, but the available evidence supports a medium fit score."
},
"references": [
{
"type": "evidence",
"label": "Senior Backend Engineer",
"url": "https://example.com/jobs/senior-backend-engineer"
}
]
}
],
"cursor": {
"next": "",
"has_more": false
}
}
Live signals
Account Signal History
Read the saved signal findings for a specific Account, including older findings, source links, and any qualification or AI score recorded for each finding.
curl --request POST \
--url 'https://api.plyne.ai/v1/accounts/co_example_01/signals/search' \
--header 'Authorization: Bearer plyne_...' \
--header 'Content-Type: application/json' \
--data '{
"cursor": {
"limit": 50
}
}'
{
"data": [
{
"id": "sig_example_01",
"type": "hiring_signals",
"name": "Hiring Activity",
"summary": "Stripe has an open Senior Backend Engineer role in this example.",
"reason": "",
"found_at": "2026-11-16T09:42:14.086180Z",
"observed_at": "2026-11-16T09:42:14.086180Z",
"source_sheet": {
"id": "sh_example_01",
"name": "Cloud infrastructure hiring"
},
"signal_agent_id": "ag_example_01",
"qualification": {
"status": "qualified",
"reason": "Stripe has an open Senior Backend Engineer role in this example.",
"reasoning": "A backend engineering opening in the US matches the tracked hiring criteria. Hiring provides relevant context, but the available evidence supports a medium fit score.",
"references": [
{
"type": "evidence",
"label": "Senior Backend Engineer",
"url": "https://example.com/jobs/senior-backend-engineer"
}
]
},
"ai_score": {
"value": 64,
"fit": "medium",
"reasoning": "A backend engineering opening in the US matches the tracked hiring criteria. Hiring provides relevant context, but the available evidence supports a medium fit score."
},
"references": [
{
"type": "evidence",
"label": "Senior Backend Engineer",
"url": "https://example.com/jobs/senior-backend-engineer"
}
]
}
],
"cursor": {
"next": "",
"has_more": false
}
}
POST /v1/accounts/{account_id}/signals/search
id returned by Accounts 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.
curl --request POST \
--url 'https://api.plyne.ai/v1/accounts/co_example_01/signals/search' \
--header 'Authorization: Bearer plyne_...' \
--header 'Content-Type: application/json' \
--data '{
"cursor": {
"limit": 50
}
}'
{
"data": [
{
"id": "sig_example_01",
"type": "hiring_signals",
"name": "Hiring Activity",
"summary": "Stripe has an open Senior Backend Engineer role in this example.",
"reason": "",
"found_at": "2026-11-16T09:42:14.086180Z",
"observed_at": "2026-11-16T09:42:14.086180Z",
"source_sheet": {
"id": "sh_example_01",
"name": "Cloud infrastructure hiring"
},
"signal_agent_id": "ag_example_01",
"qualification": {
"status": "qualified",
"reason": "Stripe has an open Senior Backend Engineer role in this example.",
"reasoning": "A backend engineering opening in the US matches the tracked hiring criteria. Hiring provides relevant context, but the available evidence supports a medium fit score.",
"references": [
{
"type": "evidence",
"label": "Senior Backend Engineer",
"url": "https://example.com/jobs/senior-backend-engineer"
}
]
},
"ai_score": {
"value": 64,
"fit": "medium",
"reasoning": "A backend engineering opening in the US matches the tracked hiring criteria. Hiring provides relevant context, but the available evidence supports a medium fit score."
},
"references": [
{
"type": "evidence",
"label": "Senior Backend Engineer",
"url": "https://example.com/jobs/senior-backend-engineer"
}
]
}
],
"cursor": {
"next": "",
"has_more": false
}
}
Path and body fields
| Field | Location | Meaning |
|---|---|---|
account_id | Path | Required Account ID. |
evaluation_id | Body | Optional exact evaluation ID. Returns only that evaluation’s visible linked findings. |
signal_types | Body | Optional stable signal type IDs. |
sheet_ids | Body | Optional source Sheet IDs. |
found_at | Body | Optional Date found range for saved signal findings. |
cursor.limit | Body | Page size; default 50, maximum 100. |
cursor.after | Body | cursor.next from the previous response. |
{} 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. Thequalification and ai_score describe the saved finding, rather than replacing it with today’s account 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
Usecursor.next as cursor.after to request another page. Keep the same Account, filters, and workspace. See Pagination and Filters for page limits and cursor behavior.
Findings behind a decision
Useevaluation_id to read findings linked to one saved evaluation. This preserves the portal’s decision-to-finding relationship. To browse the evaluations themselves, use Account 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.