curl "https://api.up2data.ai/v1/triggers?signal_id=sig_9dk2m1xq&since=2026-07-01T00:00:00Z" \
-H "X-API-Key: $UP2DATA_API_KEY"
resp = requests.get(
"https://api.up2data.ai/v1/triggers",
headers={"X-API-Key": UP2DATA_API_KEY},
params={"signal_id": "sig_9dk2m1xq", "since": "2026-07-01T00:00:00Z"},
)
triggers = resp.json()["data"]
{
"data": [
{
"id": "trg_abc123",
"signal_id": "sig_9dk2m1xq",
"external_id": "crm:workspace:42",
"metadata": { "tenant": "acme" },
"check_number": 41,
"checked_at": "2026-07-01T09:00:04Z",
"matched": true,
"criteria_matched": ["field_change:headline"],
"diff": {
"headline": { "before": "VP Eng @ Acme", "after": "CTO @ Beta" }
},
"credits_used": 1,
"webhook": { "status": "delivered", "attempts": 1 }
}
],
"meta": { "creditsUsed": 0, "billed": false, "nextCursor": "cur_9zm1pd", "requestId": "req_tl30dm1x" }
}
Triggers
List Triggers
Every match across all Signals — the queryable mirror of your webhooks.
GET
/
v1
/
triggers
curl "https://api.up2data.ai/v1/triggers?signal_id=sig_9dk2m1xq&since=2026-07-01T00:00:00Z" \
-H "X-API-Key: $UP2DATA_API_KEY"
resp = requests.get(
"https://api.up2data.ai/v1/triggers",
headers={"X-API-Key": UP2DATA_API_KEY},
params={"signal_id": "sig_9dk2m1xq", "since": "2026-07-01T00:00:00Z"},
)
triggers = resp.json()["data"]
{
"data": [
{
"id": "trg_abc123",
"signal_id": "sig_9dk2m1xq",
"external_id": "crm:workspace:42",
"metadata": { "tenant": "acme" },
"check_number": 41,
"checked_at": "2026-07-01T09:00:04Z",
"matched": true,
"criteria_matched": ["field_change:headline"],
"diff": {
"headline": { "before": "VP Eng @ Acme", "after": "CTO @ Beta" }
},
"credits_used": 1,
"webhook": { "status": "delivered", "attempts": 1 }
}
],
"meta": { "creditsUsed": 0, "billed": false, "nextCursor": "cur_9zm1pd", "requestId": "req_tl30dm1x" }
}
Cost: Free
Cursor-paginated history of matched checks. Anything a webhook delivered (or failed to deliver) is here — Trigger history is retained for 90 days.
string
Only Triggers from one Signal. Also available as
GET /v1/signals/{id}/triggers.string
Only Triggers from Signals carrying this tag.
string
Only Triggers snapshotted with this platform attribution key.
string
ISO 8601 — only Triggers checked after this time.
boolean
Default
true. Pass false to include unmatched check logs (matched: false, no diff) — the audit trail for pay-per-check billing.string
From the previous response’s
meta.nextCursor.integer
default:"50"
1–100.
curl "https://api.up2data.ai/v1/triggers?signal_id=sig_9dk2m1xq&since=2026-07-01T00:00:00Z" \
-H "X-API-Key: $UP2DATA_API_KEY"
resp = requests.get(
"https://api.up2data.ai/v1/triggers",
headers={"X-API-Key": UP2DATA_API_KEY},
params={"signal_id": "sig_9dk2m1xq", "since": "2026-07-01T00:00:00Z"},
)
triggers = resp.json()["data"]
{
"data": [
{
"id": "trg_abc123",
"signal_id": "sig_9dk2m1xq",
"external_id": "crm:workspace:42",
"metadata": { "tenant": "acme" },
"check_number": 41,
"checked_at": "2026-07-01T09:00:04Z",
"matched": true,
"criteria_matched": ["field_change:headline"],
"diff": {
"headline": { "before": "VP Eng @ Acme", "after": "CTO @ Beta" }
},
"credits_used": 1,
"webhook": { "status": "delivered", "attempts": 1 }
}
],
"meta": { "creditsUsed": 0, "billed": false, "nextCursor": "cur_9zm1pd", "requestId": "req_tl30dm1x" }
}