Get a signal
One signal with its schedule, status and the job_id of its latest run, for free.
GET
https://api.up2data.ai/v1/signals/{signal_id}Poll it as often as you like. last_job_id is the batch job the most recent successful run created; read its results with GET /v1/batch/{job_id}. For the full history use GET /v1/signals/{signal_id}/runs.
#Request
| Field | Type | Notes |
|---|---|---|
signal_idrequired | string | Path parameter. The signal_id returned by POST /signals. |
#Call it
curl -X GET "https://api.up2data.ai/v1/signals/9d1f4c2e-7b3a-4e8f-a1c5-2f6b8d9e0a11" \
-H "X-API-Key: YOUR_API_KEY"import requests
url = "https://api.up2data.ai/v1/signals/9d1f4c2e-7b3a-4e8f-a1c5-2f6b8d9e0a11"
headers = {
"X-API-Key": "YOUR_API_KEY",
}
response = requests.get(url, headers=headers)
print(response.json())const url = "https://api.up2data.ai/v1/signals/9d1f4c2e-7b3a-4e8f-a1c5-2f6b8d9e0a11";
const headers = {
"X-API-Key": "YOUR_API_KEY",
};
const response = await fetch(url, {
method: "GET",
headers,
});
const data = await response.json();
console.log(data);package main
import (
"fmt"
"io"
"net/http"
)
func main() {
url := "https://api.up2data.ai/v1/signals/9d1f4c2e-7b3a-4e8f-a1c5-2f6b8d9e0a11"
req, err := http.NewRequest("GET", url, nil)
if err != nil {
panic(err)
}
req.Header.Set("X-API-Key", "YOUR_API_KEY")
client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
respBody, _ := io.ReadAll(resp.Body)
fmt.Println(string(respBody))
}#Response
{
"data": {
"signal_id": "9d1f4c2e-7b3a-4e8f-a1c5-2f6b8d9e0a11",
"name": "Watch key accounts",
"status": "active",
"active": true,
"pause_reason": null,
"schedule": { "interval_ms": 86400000, "start_at": "2026-11-01T08:00:00Z", "ends_at": null, "max_runs": 30 },
"run_count": 3,
"next_run_at": "2026-11-04T08:00:00Z",
"last_run_at": "2026-11-03T08:00:00Z",
"last_job_id": "job_7hd92kfa",
"last_error": null,
"completed_at": null,
"request": {
"items": [
{ "type": "profile", "url": "https://linkedin.com/in/a" },
{ "type": "company", "url": "https://linkedin.com/company/acme" }
],
"webhook_url": "https://your-server.com/hooks/up2data"
},
"created_at": "2026-10-30T12:00:00Z",
"updated_at": "2026-11-03T08:00:01Z"
},
"meta": { "creditsUsed": 0, "creditsRemaining": 98413, "billed": false, "reason": "success", "requestId": "req_t4sk0001" }
}#Errors
| Status | Type | When | Billed |
|---|---|---|---|
| 404 | not_found | No signal with this signal_id in your organization, or signal_id is not a UUID. | No |
| 401 | invalid_api_key | Missing, malformed, or revoked key. | No |
| 429 | rate_limited | Over the 5,000 requests/min limit. Honor Retry-After. | No |
| 500 | internal_error | Something broke on the server side. | No |
| 503 | upstream_error | The scheduling service is unreachable. Safe to retry. | No |
See the Errors guide for every error type this version can return.