API Documentation
← All tools
GET
/api/v1/funding-roundsSearch
funding-roundsAvailable on FreeNo success wrapper
Returns a paginated list of funding rounds with company, amount, round type, date, and investor details, plus total count and timing metadata. Call it to find or filter funding rounds by sector, country, round type, company, investor, amount range, or publication date. Invalid query parameters return HTTP 400; server failures return HTTP 500.
When to use it
- Find funding rounds by sector and country
- List recent rounds for a company or investor
- Filter rounds by amount range and date
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 number of results to return. (min 1; default 1) Range: 1 to ∞ |
| limit | number | No | Number of results per page. (range 1-500; default 20) Range: 1 to 500 |
| search | string | No | Free-text query matched against round and company content; when set, results can be ranked by relevance. |
| sector | string | No | Sector to filter rounds by. |
| country | string | No | Country to filter rounds by. |
| round_type | string | No | Funding round type to filter by (e.g. seed, series A). |
| feed_name | string | No | Name of the source feed the round came from. |
| company | string | No | Company name to filter rounds by. |
| investor | string | No | Investor name to filter rounds by. |
| has_website | boolean | No | Restrict to rounds whose company has a website. |
| website_verified | boolean | No | Restrict to rounds whose company website is verified. |
| has_leadership | boolean | No | Restrict to rounds whose company has leadership information. |
| has_emails | boolean | No | Restrict to rounds whose company has contact emails. |
| has_linkedin | boolean | No | Restrict to rounds whose company has a LinkedIn profile. |
| min_amount | number | No | Minimum funding amount. (min 0) Range: 0 to ∞ |
| max_amount | number | No | Maximum funding amount. (min 0) Range: 0 to ∞ |
| amount_currency | string | No | Currency the amount filters apply to. |
| pub_date_from | string | No | Earliest publication date, ISO date YYYY-MM-DD. |
| pub_date_to | string | No | Latest publication date, ISO date YYYY-MM-DD. |
| sort | string | No | Field to sort by; relevance ranks by search match and falls back to publication date when no search is given. (default relevance) Allowed values: relevance, pub_date, processed_at, last_updated, amount_value, company_name |
| 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"
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