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.
Rate limit: funding-rounds · Free plan: 10/day
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"
Returns a single funding round by its id, including its associated organizations and recent update log entries. Call it when you have a funding round id and need its full details. Returns 404 if no funding round matches the id, and 400 if the id is malformed.
Rate limit: funding-rounds · Free plan: 10/day
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| id(path) | string | Yes | Funding round identifier. |
Example request
curl -H "x-api-key: YOUR_API_KEY" \
"https://app.caelrith.com/api/v1/funding-rounds/{id}"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.
Rate limit: funding-rounds · Free plan: 10/day
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"
Returns an aggregated profile for a company in the funding rounds data: company details, round count, round types, first and latest round dates, latest round amount, total funding amount, and deduplicated investors, founders, leadership, emails, and related organizations. Call it to look up a company's funding history and contacts by its key or name. Returns 404 if no funding rounds match the company.
Rate limit: funding-rounds · Free plan: 10/day
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| companyKey(path) | string | Yes | Company key or company name; matching is case-insensitive. |
Example request
curl -H "x-api-key: YOUR_API_KEY" \
"https://app.caelrith.com/api/v1/funding-rounds/companies/{companyKey}"Returns the current load state of the funding-rounds data, including its epoch state. Call it to check whether funding-round data is ready before querying other funding-round endpoints; it responds immediately without waiting for initialization.
Rate limit: funding-rounds · Free plan: 10/day
Parameters
No parameters.
Example request
curl -H "x-api-key: YOUR_API_KEY" \ "https://app.caelrith.com/api/v1/funding-rounds/status"