curl https://api.up2data.ai/v1/signals/sig_9dk2m1xq \
-H "X-API-Key: $UP2DATA_API_KEY"
{
"data": {
"id": "sig_9dk2m1xq",
"name": "CTO job change alert",
"tags": ["q3-pipeline"],
"external_id": "crm:workspace:42",
"metadata": { "tenant": "acme" },
"enabled": true,
"status": "active",
"schedule": { "interval": "1d", "timezone": "America/New_York" },
"target": { "type": "profile", "linkedin_url": "https://linkedin.com/in/example" },
"criteria": { "mode": "field_change", "fields": ["headline", "position", "company"], "refire": "on_change_only" },
"notify": { "webhook_url": "https://app.example.com/hooks/up2data" },
"estimated_monthly_credits": 30,
"credits_used_this_month": 7,
"last_check_at": "2026-07-07T09:00:00Z",
"next_check_at": "2026-07-08T09:00:00Z",
"last_triggered_at": "2026-07-01T09:00:04Z",
"created_at": "2026-06-01T10:00:00Z"
},
"meta": { "creditsUsed": 0, "billed": false, "requestId": "req_00ax3kd1" }
}
Signals
Get a Signal
Full Signal state, including next_check_at and spend estimate.
GET
/
v1
/
signals
/
{id}
curl https://api.up2data.ai/v1/signals/sig_9dk2m1xq \
-H "X-API-Key: $UP2DATA_API_KEY"
{
"data": {
"id": "sig_9dk2m1xq",
"name": "CTO job change alert",
"tags": ["q3-pipeline"],
"external_id": "crm:workspace:42",
"metadata": { "tenant": "acme" },
"enabled": true,
"status": "active",
"schedule": { "interval": "1d", "timezone": "America/New_York" },
"target": { "type": "profile", "linkedin_url": "https://linkedin.com/in/example" },
"criteria": { "mode": "field_change", "fields": ["headline", "position", "company"], "refire": "on_change_only" },
"notify": { "webhook_url": "https://app.example.com/hooks/up2data" },
"estimated_monthly_credits": 30,
"credits_used_this_month": 7,
"last_check_at": "2026-07-07T09:00:00Z",
"next_check_at": "2026-07-08T09:00:00Z",
"last_triggered_at": "2026-07-01T09:00:04Z",
"created_at": "2026-06-01T10:00:00Z"
},
"meta": { "creditsUsed": 0, "billed": false, "requestId": "req_00ax3kd1" }
}
Cost: Free
How Signals work
Signals are scheduled change monitoring, billed per check. See what you can watch and how it’s priced.
string
required
Signal ID, e.g.
sig_9dk2m1xq.Response
The full Signal object — definition plus runtime state:status, last_check_at, next_check_at, last_triggered_at, estimated_monthly_credits, credits_used_this_month (spend attribution), optional external_id / metadata, and paused_reason when paused (insufficient_credits | budget_exceeded | webhook_failing | user).
curl https://api.up2data.ai/v1/signals/sig_9dk2m1xq \
-H "X-API-Key: $UP2DATA_API_KEY"
{
"data": {
"id": "sig_9dk2m1xq",
"name": "CTO job change alert",
"tags": ["q3-pipeline"],
"external_id": "crm:workspace:42",
"metadata": { "tenant": "acme" },
"enabled": true,
"status": "active",
"schedule": { "interval": "1d", "timezone": "America/New_York" },
"target": { "type": "profile", "linkedin_url": "https://linkedin.com/in/example" },
"criteria": { "mode": "field_change", "fields": ["headline", "position", "company"], "refire": "on_change_only" },
"notify": { "webhook_url": "https://app.example.com/hooks/up2data" },
"estimated_monthly_credits": 30,
"credits_used_this_month": 7,
"last_check_at": "2026-07-07T09:00:00Z",
"next_check_at": "2026-07-08T09:00:00Z",
"last_triggered_at": "2026-07-01T09:00:04Z",
"created_at": "2026-06-01T10:00:00Z"
},
"meta": { "creditsUsed": 0, "billed": false, "requestId": "req_00ax3kd1" }
}