> ## Documentation Index
> Fetch the complete documentation index at: https://docs.up2data.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# List Signals

> All Signals on your account, cursor-paginated.

**Cost: Free**

<ParamField query="status" type="string">
  Filter: `active` | `paused`.
</ParamField>

<ParamField query="target_type" type="string">
  Filter: `profile` | `profile_list` | `company` | `company_jobs` | `post` | `post_search` | `people_search` | `company_search`.
</ParamField>

<ParamField query="tag" type="string">
  Only Signals carrying this tag.
</ParamField>

<ParamField query="cursor" type="string">
  From the previous response's `meta.nextCursor`.
</ParamField>

<ParamField query="limit" type="integer" default="50">
  1–100.
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl "https://api.up2data.ai/v1/signals?status=active&tag=q3-pipeline&limit=50" \
    -H "X-API-Key: $UP2DATA_API_KEY"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "data": [
      {
        "id": "sig_9dk2m1xq",
        "name": "CTO job change alert",
        "tags": ["q3-pipeline"],
        "status": "active",
        "target": { "type": "profile", "linkedin_url": "https://linkedin.com/in/example" },
        "schedule": { "interval": "1d" },
        "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"
      }
    ],
    "meta": { "creditsUsed": 0, "billed": false, "nextCursor": "cur_8an2xx", "requestId": "req_l2m10ssd" }
  }
  ```
</ResponseExample>