Fundup AI Fundup AI API v1.4.0
Try API

Getting Started

Quick Start

Authenticate and make your first API call in a couple of minutes.

Prerequisites

Scale plan required

API access is available exclusively to Scale plan subscribers. If you don't have a Scale plan, upgrade your subscription to access the API.

Authentication

All API requests require an API key. You can create API keys in your account settings.

Step 1: Create an API key

  1. Go to your Dashboard
  2. Click "Settings" in the sidebar
  3. Navigate to the "API" tab
  4. Click "Generate New Key"
  5. Give your key a name and select the type (Production or Test)
  6. Copy the generated API key, you won't see it again

Step 2: Use your API key

Include your API key in the Authorization header of all requests:

Header 
Authorization: Bearer YOUR_API_KEY_HERE

Your first request

Start with a health check to verify your API key is working.

curl 
curl -X GET "https://fundup.ai/api/v1/health" \
  -H "Authorization: Bearer YOUR_API_KEY_HERE"
200: Response
{
  "status": "healthy",
  "timestamp": 1640995200
}

Get companies

Retrieve companies with filtering and pagination.

curl 
curl -X GET "https://fundup.ai/api/v1/companies?funding_date_start=2025-01-01&funding_date_end=2025-12-31&limit=5&countries[]=US&industries[]=Financial+Services" \
  -H "Authorization: Bearer YOUR_API_KEY_HERE"
200: Response
{
  "data": [
    {
      "id": "comp_123",
      "companyName": "Example AI Corp",
      "country": "US",
      "country_name": "United States",
      "stage": "Series A",
      "fundingAmount": "5M",
      "currency": "USD",
      "fundingAnnounceDate": "2025-09-18"
    }
  ],
  "pagination": { "limit": 5, "offset": 0, "total": 1, "has_more": false }
}

Pair the API with webhooks

The API works best as a webhook + endpoint combination. A webhook notifies you the moment a company raises funding (no polling, no scanning) and you call the API on demand only for the companies that matter (contacts, full profile). Used this way you stay comfortably within rate limits, and it's the setup we recommend for tracking fresh signals. Read the webhooks guide →

Available filter values

Fetch valid values for filters to ensure you're using correct parameters.

curl 
curl -X GET "https://fundup.ai/api/v1/filters" \
  -H "Authorization: Bearer YOUR_API_KEY_HERE"
200: Response
{
  "success": true,
  "data": {
    "countries": ["US", "GB", "DE", "FR", "CA"],
    "industries": ["Financial Services", "Healthcare & Life Sciences", "Energy & Sustainability", "Education", "..."],
    "stages": ["Pre-Seed", "Seed", "Series A", "Series B", "Series C+", "Debt", "Bootstrapped", "Undisclosed"],
    "company_sizes": ["1-10", "11-50", "51-200", "201-1000"]
  }
}

Filtering and pagination

The API supports powerful filtering and pagination options.

Common filters

  • countries[]: filter by country (2-letter ISO codes like "US", "GB")
  • industries[]: filter by industry. Use GET /api/v1/filters for exact values.
  • stages[]: filter by funding stage (case-insensitive)
  • min_funding: minimum funding amount (e.g. "1M", "500K")
  • max_funding: maximum funding amount (e.g. "10M", "2B")
  • search: search in company names / descriptions

Array formats, all three work: industries[]=Fintech&industries[]=Healthcare (bracket), industries=Fintech&industries=Healthcare (repeated), or industries=["Fintech","Healthcare"] (JSON array, Postman default).

Pagination

  • limit: number of results (max 50)
  • offset: skip results for pagination
  • Responses include pagination metadata
  • Use has_more to check for more results

Funding amount format

Funding amounts support flexible formats with suffixes:

  • 1M = $1,000,000 (1 million)
  • 500K = $500,000 (500 thousand)
  • 2.5B = $2,500,000,000 (2.5 billion)
  • 1000000 = $1,000,000 (plain number)
  • $1M = $1,000,000 (with currency symbol)

Supported suffixes: K (thousands), M (millions), B (billions).

Next steps

Ready to explore more?