Skip to main content
The Alerts API lets a scheduled job retrieve the deals matched by your saved Fundable alerts. A reliable workflow first discovers the available configurations, then requests matches for a bounded UTC time window.
GET /alerts and GET /alerts/configurations are available on Pro+ and Enterprise plans. Both endpoints consume zero credits. See Pricing and Credits.

1. List alert configurations

GET /alerts/configurations returns the authenticated user’s alert IDs, filters, frequency, and descriptions. It does not consume usage credits.
Store the alert IDs you want the workflow to process. You can request up to 10 alert IDs at once.

2. Request matching deals

Pass a comma-separated list of alert IDs and an inclusive UTC date range.
The response returns each alert in data.alerts with a flattened deals array. Deals are sorted newest first and deduplicated within the API response. Each match also includes reasoning that explains why the deal satisfied the alert and an articles array containing its related sources. Use narrower date ranges or fewer alert IDs to keep response payloads smaller and downstream processing faster.

3. Process matches safely

Use the deal UUID as the idempotency key in your destination.
  1. Read the last successful UTC checkpoint.
  2. Request a short overlapping time window.
  3. Upsert or skip each deal by UUID.
  4. Record per-item failures for retry.
  5. Advance the checkpoint only when the complete batch succeeds.
An overlap is safe because the destination deduplicates by UUID. It also protects against scheduler delays and partial failures.

4. Route by alert

Keep alertId, alertName, and the match reasoning with each downstream record. Those fields let you route different alerts to different Slack channels, CRM lists, email sequences, or analyst queues without reimplementing the filter logic.

Funding Alerts API

Review query parameters and the response schema.

Alert configurations

Retrieve the alerts available to the authenticated user.
Last modified on August 29, 2026