/api/v1/funding-opportunitiesSearch
Returns a paginated list of funding opportunities, optionally filtered by source, status, sponsor, mention, funding range, and date windows, or narrowed by one search lane (search, query, or semantic). Call it to browse or search funding opportunities. Fails with 400 when source values are unknown, when more than one of search/query/semantic is supplied, or when a non-relevance sort is combined with a search lane.
When to use it
- Browse funding opportunities by status and deadline
- Find funding opportunities matching a phrase or boolean query
- Filter opportunities by sponsor, funding range, or posting 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 regulatoryApiCallsPerDay. Exceeding it returns HTTP 429.
Plans and daily limits
| Plan | Available | Calls / day |
|---|---|---|
| free | yes | 30 |
| 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 |
|---|---|---|---|
| search | string | No | maximum length 2000 |
| query | string | No | maximum length 2000 |
| semantic | string | No | maximum length 2000 |
| source | string (comma-separated) | No | [comma-separated list] maximum length 200; array parameter - sent as a single comma-separated string; value is parsed from the raw query string and coerced server-side |
| status | string (comma-separated) | No | [comma-separated list] maximum length 200; array parameter - sent as a single comma-separated string; value is parsed from the raw query string and coerced server-side |
| funding_min | number | No | Lower bound on funding amount. |
| funding_max | number | No | Upper bound on funding amount. |
| deadline_after | string | No | maximum length 40 |
| deadline_before | string | No | maximum length 40 |
| posted_after | string | No | maximum length 40 |
| ingested_after | string | No | maximum length 40 |
| updated_since | string | No | maximum length 40 |
| sponsor | string | No | maximum length 500 |
| mention | string | No | maximum length 500 |
| page | number | No | Min 1; default 1 (min 1; default 1) Range: 1 to ∞ |
| limit | number | No | Range 1-200; default 20 (range 1-200; default 20) Range: 1 to 200 |
| sort | string | No | Ordering of results; a value other than relevance cannot be combined with a search lane. Allowed values: relevance, updated, deadline, start_date, funding |
| order | string | No | Default desc (default desc) Allowed values: asc, desc |
Example request
curl -H "x-api-key: YOUR_API_KEY" \ "https://app.caelrith.com/api/v1/funding-opportunities"
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