Skip to main content
GET
/
alerts
Get alert data with deals
curl --request GET \
  --url https://tryfundable.ai/api/v1/alerts \
  --header 'Authorization: Bearer <token>'
{
  "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 authentication using Bearer token format. Format: Authorization: Bearer vg_your_api_key_here

API keys follow the pattern: vg_[12_hex_chars]_[32_base64url_chars]

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
​
meta
object
required