Fundup AI

Fundup AI API

v1.1.0

API Reference

Complete reference for all available endpoints

Try API

This reference provides detailed information about all available API endpoints. Each endpoint includes parameters, example requests, and response formats.

GET /health

Health check endpoint to verify API status

Example Request

curl 
curl -X GET "https://fundup.ai/api/v1/health" \
  -H "Authorization: Bearer YOUR_API_KEY_HERE"

Example Response

200 OK 
{
  "message": "API is running",
  "status": "healthy",
  "timestamp": 1703123456,
  "version": "1.0.0"
}
GET /companies

Retrieve a list of companies with advanced filtering and optimized server-side pagination. Uses hybrid database filtering for improved performance.

Parameters

Parameter Type Required Description
funding_date_start string Yes Start date for funding events (required)
funding_date_end string Yes End date for funding events (required)
limit integer No Number of companies to return (1-50). Maximum 50 records per request.
offset integer No Number of companies to skip (0-499). Maximum 500 total records accessible via API.
min_funding string No Minimum funding amount (e.g., "1M", "500K", "2.5B")
max_funding string No Maximum funding amount (e.g., "10M", "2B", "100K")
countries array No Filter by countries using 2-letter ISO codes (e.g., ["US", "GB", "DE"])
stages array No Filter by funding stages (e.g., ["Seed", "Series A", "Series B", "undisclosed"])
industries array No Filter by industries (e.g., ["AI", "Fintech", "Healthcare"])
company_size array No Filter by company size (e.g., ["1-10", "11-50", "51-200"])
currently_hiring boolean No Filter by hiring status (true/false)
validated_contacts boolean No Show only companies with validated contacts (true = only validated, omit or false = all companies)
investors array No Filter by investor names
currency string No Filter by funding currency (e.g., "USD", "EUR", "GBP")
search string No Search in company names, descriptions, and industries

Example Request

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&search=tech&validated_contacts=true" \
  -H "Authorization: Bearer YOUR_API_KEY_HERE"

Example Response

200 OK 
{
  "data": [
    {
      "companyName": "Example Corp",
      "country": "US",
      "country_name": "United States",
      "currency": "USD",
      "currentlyHiring": true,
      "description": "AI-powered solution",
      "fundingAmount": "5M",
      "fundingAnnounceDate": "2025-09-18",
      "id": "comp_123",
      "industries": [
        "AI",
        "SaaS"
      ],
      "stage": "Series A",
      "validatedContacts": true
    },
    {
      "companyName": "Stealth Startup",
      "country": "US",
      "country_name": "United States",
      "currency": "USD",
      "currentlyHiring": false,
      "description": "Confidential AI platform",
      "fundingAmount": "2M",
      "fundingAnnounceDate": "2025-08-15",
      "id": "comp_124",
      "industries": [
        "AI",
        "Enterprise"
      ],
      "stage": "Seed",
      "validatedContacts": false
    }
  ],
  "pagination": {
    "has_more": false,
    "limit": 25,
    "offset": 0,
    "total": 2
  }
}

Error Responses

401 Unauthorized - Invalid or missing API key 
{
  "error": "Invalid API key"
}
429 Too Many Requests - Rate limit exceeded 
{
  "error": "Rate limit exceeded",
  "message": "You have exceeded your monthly request limit"
}
GET /companies/{company_id}

Get detailed information about a specific company

Parameters

Parameter Type Required Description
company_id string Yes Unique company identifier

Example Request

curl 
curl -X GET "https://fundup.ai/api/v1/companies/comp_123" \
  -H "Authorization: Bearer YOUR_API_KEY_HERE"

Example Response

200 OK 
{
  "companyName": "Example Corp",
  "contacts": [
    {
      "email": "[email protected]",
      "id": "contact_789",
      "name": "John Doe",
      "title": "CEO"
    }
  ],
  "country": "United States",
  "country_name": "United States",
  "description": "AI-powered solution",
  "fundings": [
    {
      "fundingAmount": "5M",
      "fundingAnnounceDate": "2025-09-18",
      "id": "fund_456",
      "stage": "Series A"
    }
  ],
  "highlights": [
    {
      "highlight": "Company raised $5M in Series A funding",
      "id": "highlight_123",
      "source": "news"
    },
    {
      "highlight": "AI-powered solution with strong market traction",
      "id": "highlight_124",
      "source": "ai"
    }
  ],
  "id": "comp_123",
  "industries": [
    "AI",
    "SaaS"
  ],
  "linkedinUrl": "https://linkedin.com/company/example",
  "total_contacts": 1,
  "total_fundings": 1,
  "total_job_listings": 5,
  "website": "https://example.com"
}

Error Responses

404 Company not found 
{
  "error": "Company not found",
  "message": "The requested company could not be found"
}
GET /fundings

Retrieve recent funding events with advanced filtering and optimized server-side pagination. Uses hybrid database filtering for improved performance.

Parameters

Parameter Type Required Description
funding_date_start string Yes Start date for funding events (required)
funding_date_end string Yes End date for funding events (required)
limit integer No Number of fundings to return (1-50). Maximum 50 records per request.
offset integer No Number of fundings to skip (0-499). Maximum 500 total records accessible via API.
min_amount string No Minimum funding amount (e.g., "1M", "500K", "2.5B")
max_amount string No Maximum funding amount (e.g., "10M", "2B", "100K")
stages array No Filter by funding stages (e.g., ["Seed", "Series A", "Series B", "undisclosed"])
countries array No Filter by company countries using 2-letter ISO codes
industries array No Filter by company industries
currency string No Filter by funding currency (e.g., "USD", "EUR", "GBP", "INR", "TRY", "JPY")
investors array No Filter by investor names
company_size array No Filter by company size categories
currently_hiring boolean No Filter by companies currently hiring (true/false)
validated_contacts boolean No Show only companies with validated contacts (true = only validated, omit or false = all companies)
search string No Search across company names, descriptions, and industries

Example Request

curl 
curl -X GET "https://fundup.ai/api/v1/fundings?funding_date_start=2025-01-01&funding_date_end=2025-12-31&limit=10&stages[]=Series%20A&currency=USD&search=tech&validated_contacts=true" \
  -H "Authorization: Bearer YOUR_API_KEY_HERE"

Example Response

200 OK 
{
  "data": [
    {
      "company": {
        "country": "US",
        "id": "comp_123",
        "industries": [
          "AI",
          "SaaS"
        ],
        "name": "Example Corp"
      },
      "currency": "USD",
      "fundingAmount": "5M",
      "fundingAnnounceDate": "2025-09-18",
      "id": "fund_456",
      "stage": "Series A"
    },
    {
      "company": {
        "country": "DE",
        "id": "comp_124",
        "industries": [
          "AI",
          "Enterprise"
        ],
        "name": "European Startup"
      },
      "currency": "EUR",
      "fundingAmount": "2.5M",
      "fundingAnnounceDate": "2025-08-15",
      "id": "fund_457",
      "stage": "Series A"
    }
  ],
  "pagination": {
    "has_more": false,
    "limit": 50,
    "offset": 0,
    "total": 2
  }
}

Error Responses

401 Unauthorized - Invalid or missing API key 
{
  "error": "Invalid API key"
}
429 Too Many Requests - Rate limit exceeded 
{
  "error": "Rate limit exceeded",
  "message": "You have exceeded your monthly request limit"
}
GET /filters

Get available filter values for API endpoints (countries, industries, stages, company sizes)

Example Request

curl 
curl -X GET "https://fundup.ai/api/v1/filters" \
  -H "Authorization: Bearer YOUR_API_KEY_HERE"

Example Response

200 OK 
{
  "data": {
    "company_sizes": [
      "1-10",
      "11-50",
      "51-200",
      "201-1000",
      "1000+"
    ],
    "countries": [
      "US",
      "GB",
      "DE",
      "FR",
      "CA"
    ],
    "currencies": [
      "USD",
      "EUR",
      "GBP",
      "INR",
      "TRY",
      "JPY",
      "KRW"
    ],
    "industries": [
      "AI",
      "Fintech",
      "Healthcare",
      "SaaS",
      "E-commerce"
    ],
    "stages": [
      "Seed",
      "Series A",
      "Series B",
      "Series C+",
      "Debt",
      "undisclosed"
    ]
  },
  "success": true,
  "timestamp": 1703123456
}
GET /stats

Get API usage statistics for the authenticated user

Example Request

curl 
curl -X GET "https://fundup.ai/api/v1/stats" \
  -H "Authorization: Bearer YOUR_API_KEY_HERE"

Example Response

200 OK 
{
  "data": {
    "api_key": {
      "created_at": 1703123456,
      "name": "Production Key",
      "type": "live"
    },
    "rate_limit_remaining": 9555,
    "requests_this_month": 45,
    "total_requests": 150,
    "user_rate_limit": 10000
  },
  "success": true,
  "timestamp": 1703123456
}
POST /companies/{id}/follow

Follow a company to receive updates and notifications

Parameters

Parameter Type Required Description
id string Yes Company ID (path parameter)

Example Request

curl 
curl -X POST "https://fundup.ai/api/v1/companies/comp_123/follow" \
  -H "Authorization: Bearer YOUR_API_KEY_HERE" \
  -H "Content-Type: application/json"

Example Response

200 OK 
{
  "company_id": "comp_123",
  "company_name": "Example Corp",
  "message": "Company followed successfully",
  "success": true
}

Error Responses

400 Bad Request - Company already followed or invalid request 
{
  "error": "Company is already being followed"
}
404 Company not found 
{
  "error": "Company not found"
}
DELETE /companies/{id}/follow

Unfollow a company to stop receiving updates and notifications

Parameters

Parameter Type Required Description
id string Yes Company ID (path parameter)

Example Request

curl 
curl -X DELETE "https://fundup.ai/api/v1/companies/comp_123/follow" \
  -H "Authorization: Bearer YOUR_API_KEY_HERE"

Example Response

200 OK 
{
  "company_id": "comp_123",
  "company_name": "Example Corp",
  "message": "Company unfollowed successfully",
  "success": true
}

Error Responses

400 Bad Request - Company not being followed 
{
  "error": "Company is not being followed"
}
404 Company not found 
{
  "error": "Company not found"
}
GET /following/companies

Get list of companies you are following with detailed information

Parameters

Parameter Type Required Description
page integer No Page number for pagination
per_page integer No Number of companies per page (1-100)

Example Request

curl 
curl -X GET "https://fundup.ai/api/v1/following/companies?page=1&per_page=25" \
  -H "Authorization: Bearer YOUR_API_KEY_HERE"

Example Response

200 OK 
{
  "data": {
    "followed_companies": [
      {
        "company_id": "comp_123",
        "company_logo": "https://example.com/logo.png",
        "company_name": "Example Corp",
        "country": "United States",
        "currency": "USD",
        "description": "AI-powered solution for enterprise customers",
        "followed_at": "2025-09-19T14:20:00Z",
        "fundingAmount": "5M",
        "fundingAnnounceDate": "2025-09-18",
        "icpMatch": 85,
        "industries": [
          "AI",
          "SaaS",
          "Enterprise"
        ],
        "last_updated": "2025-09-20T10:30:00Z",
        "notification_preferences": {
          "crm": false,
          "email": true,
          "slack": false,
          "webhook": false
        },
        "stage": "Series A"
      }
    ],
    "page": 1,
    "per_page": 25,
    "total_count": 1,
    "total_pages": 1
  },
  "success": true
}

Error Responses

400 Bad Request - Invalid pagination parameters 
{
  "error": "Invalid page or per_page parameter"
}
GET /following/companies/{id}/activities

Get activities and updates for a specific followed company

Parameters

Parameter Type Required Description
id string Yes Company ID (path parameter)
page integer No Page number for pagination
per_page integer No Number of activities per page (1-50)

Example Request

curl 
curl -X GET "https://fundup.ai/api/v1/following/companies/comp_123/activities?page=1&per_page=10" \
  -H "Authorization: Bearer YOUR_API_KEY_HERE"

Example Response

200 OK 
{
  "data": {
    "activities": [
      {
        "amount": "5M",
        "currency": "USD",
        "date": "2025-09-18T00:00:00Z",
        "description": "Company raised $5M in Series A funding",
        "id": "act_123",
        "source": "TechCrunch",
        "stage": "Series A",
        "title": "Series A Funding Round",
        "type": "funding",
        "url": "https://techcrunch.com/example-funding"
      }
    ],
    "page": 1,
    "per_page": 10,
    "total_count": 1,
    "total_pages": 1
  },
  "success": true
}

Error Responses

404 Company not found or not being followed 
{
  "error": "Company not found or not being followed"
}