/api/v1/funding-rounds/companiesCompanies
Returns a paginated list of companies aggregated from their funding rounds, each with company profile fields, round count, round types, first and latest round dates, latest round type and amount, total funding amount, currencies, investors, emails, founders, and leadership. Call it to browse or filter companies by sector, country, round type, verification, leadership or email availability, and to sort by recency, name, round count, or total amount. Invalid query parameters return HTTP 400.
When to use it
- List funded companies in a sector or country
- Find companies with the most funding rounds or highest total funding
- Filter companies that have leadership or contact emails available
Getting started
Base URL
https://app.caelrith.com/api/v1/toolsAuthentication
Include your API key in the x-api-key header.
Rate limit
Every call counts against your workspace’s daily quota for funding-rounds. Exceeding it returns HTTP 429.
Plans and daily limits
| Plan | Available | Calls / day |
|---|---|---|
| free | yes | 10 |
| pro | yes | 200 |
| custom (default) | yes | 10,000 |
Plan defaults. A custom workspace may carry per-tenant overrides.
Parameters
Query parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| page | number | No | Page of results to return. (min 1; default 1) Range: 1 to ∞ |
| limit | number | No | Number of companies per page. (range 1-500; default 20) Range: 1 to 500 |
| sector | string | No | Sector label to restrict results to. |
| country | string | No | Country label to restrict results to. |
| round_type | string | No | Funding round type a company must have at least one of. |
| website_verified | boolean | No | Restrict to companies whose website is verified (true) or not (false). |
| has_leadership | boolean | No | Restrict to companies with (true) or without (false) leadership contacts. |
| has_emails | boolean | No | Restrict to companies with (true) or without (false) contact emails. |
| min_round_count | integer | No | Only include companies with at least this many funding rounds. (min 1) Range: 1 to ∞ |
| min_total_amount | number | No | Only include companies whose summed funding amount reaches this value. (min 0) Range: 0 to ∞ |
| sort | string | No | Field to order results by. (default latest_round_date) Allowed values: latest_round_date, company_name, round_count, total_amount |
| order | string | No | Sort direction, ascending or descending. (default desc) Allowed values: asc, desc |
Example request
curl -H "x-api-key: YOUR_API_KEY" \ "https://app.caelrith.com/api/v1/funding-rounds/companies"
Response envelope
This endpoint returns an implicit 2xx response - there is no success flag in the body.
{
"data": { /* payload */ },
"meta": { /* pagination, totals */ }
}
// No "success" flag on this endpoint - any 2xx JSON is a success.Catalog version mcp-2026-10-28 · generated from the live MCP catalog