Get alert data with deals

curl --request GET \
  --url https://www.tryfundable.ai/api/v1/alerts \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://www.tryfundable.ai/api/v1/alerts"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://www.tryfundable.ai/api/v1/alerts', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://www.tryfundable.ai/api/v1/alerts",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://www.tryfundable.ai/api/v1/alerts"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://www.tryfundable.ai/api/v1/alerts")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://www.tryfundable.ai/api/v1/alerts")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "success": true,
  "data": {
    "alerts": [
      {
        "alertId": "550e8400-e29b-41d4-a716-446655440000",
        "alertName": "Weekly AI Funding Deals",
        "alertFrequency": "WEEKLY",
        "totalDealCount": 25,
        "deals": [
          {
            "id": "deal1",
            "company_id": "comp1",
            "company_name": "Acme AI Corp",
            "company_guru_permalink": "acme-ai-corp",
            "round_type": "SERIES_A",
            "total_round_raised": 25,
            "date": "2024-01-15T00:00:00.000Z",
            "company_website": "acme.com",
            "company_linkedin": "https://linkedin.com/company/acme",
            "location": {
              "city": "San Francisco",
              "state": "California",
              "country": "United States",
              "region": "North America"
            },
            "deal_short_description": "Series A funding round",
            "deal_long_description": "Acme AI Corp raised $25M in Series A funding",
            "reasoning": "Matches AI startups criteria with focus on artificial intelligence",
            "articles": [
              {
                "link": "https://techcrunch.com/article1",
                "is_primary": true,
                "publishedDate": "2024-01-15T00:00:00.000Z"
              }
            ]
          },
          {
            "id": "deal3",
            "company_id": "comp3",
            "company_name": "ML Solutions Inc",
            "company_guru_permalink": "ml-solutions-inc",
            "round_type": "SERIES_B",
            "total_round_raised": 40,
            "date": "2024-01-10T00:00:00.000Z",
            "company_website": "mlsolutions.com",
            "company_linkedin": null,
            "location": {
              "city": "London",
              "state": null,
              "country": "United Kingdom",
              "region": "Europe"
            },
            "deal_short_description": "Series B funding",
            "deal_long_description": "ML Solutions raised $40M in Series B",
            "reasoning": "Machine learning focus aligns with your alert criteria",
            "articles": []
          }
        ]
      },
      {
        "alertId": "660e8400-e29b-41d4-a716-446655440001",
        "alertName": "Monthly Healthcare Seed Deals",
        "alertFrequency": "MONTHLY",
        "totalDealCount": 22,
        "deals": [
          {
            "id": "deal2",
            "company_id": "comp2",
            "company_name": "HealthTech Startup",
            "company_guru_permalink": "healthtech-startup",
            "round_type": "SEED",
            "total_round_raised": 5,
            "date": "2024-01-10T00:00:00.000Z",
            "company_website": "healthtech.io",
            "company_linkedin": "https://linkedin.com/company/healthtech",
            "location": {
              "city": "Boston",
              "state": "Massachusetts",
              "country": "United States",
              "region": "North America"
            },
            "deal_short_description": "Seed funding round",
            "deal_long_description": "HealthTech Startup raised $5M in seed funding",
            "reasoning": "Healthcare focus matches your seed round criteria",
            "articles": [
              {
                "link": "https://healthcarevc.com/article",
                "is_primary": true,
                "publishedDate": "2024-01-10T00:00:00.000Z"
              }
            ]
          }
        ]
      }
    ]
  },
  "meta": {
    "total_count": 47,
    "page": 0,
    "page_size": 2,
    "credits_used": 47
  }
}

Alerts

List Alerts

Retrieve saved alert data including all deals that matched the alert criteria within the specified date range. Results include a flattened array of deals sorted by date (newest first) with duplicates removed.

Multiple Alerts Support:

Query multiple alerts in a single request (up to 10)
Each alert returns its own flattened deals array
Different alerts can have different frequencies (e.g., one daily, one weekly)
Total deal count across all alerts determines rate limit usage

Important Notes:

All alert_ids must belong to alerts you have access to
Deals are flattened from all time periods and sorted by date DESC (newest first)
Duplicate deals are automatically removed
Each deal includes AI-generated reasoning for why it matched the alert criteria
Deal structure is simplified with flattened company information for easier integration

GET

alerts

Get alert data with deals

curl --request GET \
  --url https://www.tryfundable.ai/api/v1/alerts \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://www.tryfundable.ai/api/v1/alerts"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://www.tryfundable.ai/api/v1/alerts', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://www.tryfundable.ai/api/v1/alerts",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://www.tryfundable.ai/api/v1/alerts"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://www.tryfundable.ai/api/v1/alerts")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://www.tryfundable.ai/api/v1/alerts")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "success": true,
  "data": {
    "alerts": [
      {
        "alertId": "550e8400-e29b-41d4-a716-446655440000",
        "alertName": "Weekly AI Funding Deals",
        "alertFrequency": "WEEKLY",
        "totalDealCount": 25,
        "deals": [
          {
            "id": "deal1",
            "company_id": "comp1",
            "company_name": "Acme AI Corp",
            "company_guru_permalink": "acme-ai-corp",
            "round_type": "SERIES_A",
            "total_round_raised": 25,
            "date": "2024-01-15T00:00:00.000Z",
            "company_website": "acme.com",
            "company_linkedin": "https://linkedin.com/company/acme",
            "location": {
              "city": "San Francisco",
              "state": "California",
              "country": "United States",
              "region": "North America"
            },
            "deal_short_description": "Series A funding round",
            "deal_long_description": "Acme AI Corp raised $25M in Series A funding",
            "reasoning": "Matches AI startups criteria with focus on artificial intelligence",
            "articles": [
              {
                "link": "https://techcrunch.com/article1",
                "is_primary": true,
                "publishedDate": "2024-01-15T00:00:00.000Z"
              }
            ]
          },
          {
            "id": "deal3",
            "company_id": "comp3",
            "company_name": "ML Solutions Inc",
            "company_guru_permalink": "ml-solutions-inc",
            "round_type": "SERIES_B",
            "total_round_raised": 40,
            "date": "2024-01-10T00:00:00.000Z",
            "company_website": "mlsolutions.com",
            "company_linkedin": null,
            "location": {
              "city": "London",
              "state": null,
              "country": "United Kingdom",
              "region": "Europe"
            },
            "deal_short_description": "Series B funding",
            "deal_long_description": "ML Solutions raised $40M in Series B",
            "reasoning": "Machine learning focus aligns with your alert criteria",
            "articles": []
          }
        ]
      },
      {
        "alertId": "660e8400-e29b-41d4-a716-446655440001",
        "alertName": "Monthly Healthcare Seed Deals",
        "alertFrequency": "MONTHLY",
        "totalDealCount": 22,
        "deals": [
          {
            "id": "deal2",
            "company_id": "comp2",
            "company_name": "HealthTech Startup",
            "company_guru_permalink": "healthtech-startup",
            "round_type": "SEED",
            "total_round_raised": 5,
            "date": "2024-01-10T00:00:00.000Z",
            "company_website": "healthtech.io",
            "company_linkedin": "https://linkedin.com/company/healthtech",
            "location": {
              "city": "Boston",
              "state": "Massachusetts",
              "country": "United States",
              "region": "North America"
            },
            "deal_short_description": "Seed funding round",
            "deal_long_description": "HealthTech Startup raised $5M in seed funding",
            "reasoning": "Healthcare focus matches your seed round criteria",
            "articles": [
              {
                "link": "https://healthcarevc.com/article",
                "is_primary": true,
                "publishedDate": "2024-01-10T00:00:00.000Z"
              }
            ]
          }
        ]
      }
    ]
  },
  "meta": {
    "total_count": 47,
    "page": 0,
    "page_size": 2,
    "credits_used": 47
  }
}

Authorizations

Authorization

string

header

required

API key provided as a Bearer token

Query Parameters

alert_ids

string

required

Comma-separated list of alert UUIDs (up to 10 alerts per request). All alerts must be associated with your API key's account. Example: "uuid1,uuid2,uuid3"

Example:

"550e8400-e29b-41d4-a716-446655440000,660e8400-e29b-41d4-a716-446655440001"

start_date

string<date-time>

required

Start date for the alert data range (ISO 8601 format). Results will include deals from this date onwards.

Example:

"2024-01-01T00:00:00.000Z"

end_date

string<date-time>

required

End date for the alert data range (ISO 8601 format). Results will include deals up to and including this date.

Note: All dates are processed in UTC timezone. Deals are grouped into time periods based on UTC date boundaries.

Example:

"2024-12-31T23:59:59.999Z"

Response

Successful response with alert data organized by time periods

success

boolean

required

Example:

true

data

object

required

Show child attributes

Overview

Deals

Companies

Investors

People

Filters

Alerts

List Alerts

Authorizations

Query Parameters

Response