Skip to content

Signals

Changes between runs worth attention. Open until the condition clears (resolved) or the organization’s owner dismisses them in the dashboard. Beta: these shapes may change; see the changelog.

GET /audits/{auditId}/signals

Open and dismissed signals (at most 100), then signals resolved in the last 30 days (at most 50). truncated says whether either list hit its cap.

Terminal window
curl "https://api.beket.ai/api/v1/audits/AUDIT_ID/signals" \
-H "Authorization: Bearer $BEKET_API_KEY"
NameInRequiredTypeDescription
auditIdpathyesstringThe audit’s id.
FieldTypeRequiredDescription
successbooleanyes
dataobjectyes
data.signalsobject[]yes
data.signals[].idstringyes
data.signals[].kind“new_competitor” | “entity_disappeared” | “new_citation_source” | “metric_delta” | “edge_blocked_crawler”yes
data.signals[].state“open” | “dismissed” | “resolved”yes
data.signals[].dedupKeystringyesIdentifies the condition; a recurrence of a resolved one is a new signal.
data.signals[].payloadobjectyesKind-specific detail (the competitor, the source, the metric and its delta).
data.signals[].firstSeenAtstringyes
data.signals[].lastSeenAtstringyes
data.signals[].resolvedAtstring | nullyes
data.signals[].dismissedAtstring | nullyes
data.signals[].firstSeenSnapshotIdstring | null
data.signals[].lastSeenSnapshotIdstring | null
data.truncatedobjectyes
data.truncated.livebooleanyes
data.truncated.resolvedbooleanyes
{
"success": true,
"data": {
"signals": [
{
"id": "clrecordersignal000000001",
"kind": "new_competitor",
"state": "open",
"dedupKey": "new_competitor:rival",
"payload": {
"subject": "Rival"
},
"firstSeenAt": "2026-10-25T19:53:04.852Z",
"lastSeenAt": "2026-10-25T19:53:04.852Z",
"resolvedAt": null,
"dismissedAt": null,
"firstSeenSnapshotId": "00000000-0000-4000-8000-00000000e102",
"lastSeenSnapshotId": "00000000-0000-4000-8000-00000000e102"
}
],
"truncated": {
"live": false,
"resolved": false
}
}
}