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

# list alerts

`GET /signals/alerts`

An alert is a source of signals. Read them with `list_signals`. Lists sources with signal counts, lead counts and last job state. Free.

An alert is a source of signals. Read them with `list_signals`. Lists sources with signal counts, lead counts and last job state. Free.

Cost: Free.

## Response

- `kind` | enum | required.  Values: `linkedin_profile`, `linkedin_post`.
- `target` | string | required.
- `id` | string | required.
- `cadence` | enum | required.  Values: `daily`, `manual`.
- `billing_choice` | enum | required.  Values: `backfill_and_new`, `new_only`.
- `active` | boolean | required.
- `last_polled_at` | any | required.
- `removed_at` | any | required.
- `created_at` | string | required.
- `signals` | integer | required.
- `leads` | integer | required.
- `last_job_status` | any | required.

## Failures

| Status | Meaning |
| --- | --- |
| `400` | The request shape, a filter key, a value, a cursor or the enrichment mode was rejected. |
| `401` | The credential is missing, unknown or revoked. |
| `429` | The key passed 300 requests a minute or 2 concurrent requests. |
| `503` | The data is unavailable for a short time. |

## Example

```bash
curl -sS "https://api.leadmcp.ai/v1/signals/alerts" \
  -H "Authorization: Bearer lm_live_YOUR_API_KEY" \
  -H "LeadMCP-Version: 2026-09-19"
```

Response `200`:

```json
{
  "ok": true,
  "request_id": "req_01JBQ2W8K9V6M3T0X5Y7Z4A1BC",
  "release": "b_2026_09_15",
  "data": [
    {
      "kind": "linkedin_profile",
      "target": "https://www.linkedin.com/in/example",
      "id": "01ARZ3NDEKTSV4RRFFQ69G5FAV",
      "cadence": "daily",
      "billing_choice": "backfill_and_new",
      "active": true,
      "last_polled_at": null,
      "removed_at": null,
      "created_at": "2026-09-19T09:15:00Z",
      "signals": 10,
      "leads": 8,
      "last_job_status": "completed"
    }
  ],
  "quota": {
    "plan": "free",
    "contact_credits_used": 50,
    "month_remaining": 950,
    "today_remaining": 950,
    "binding": "month",
    "resets_at": "9999-12-31T23:59:59.000Z"
  },
  "warnings": []
}
```