/api/v1/financials/filingsFilings
Returns a paginated, filtered, sorted list of SEC filings with page metadata (totalItems, totalPages, hasMore) and the applied sort/order. Use it to browse filings by ticker, form type, filing date range, or to poll for filings changed since a prior cursor. Returns 400 for invalid or explicitly empty tickers/form_types or an unparseable updated_since, 503 when the feed is not available on the current data epoch, and 500 on unexpected failure.
When to use it
- List recent filings for one or more tickers
- Poll for filings updated since a last-seen timestamp
- Filter filings by form type and filing date range
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 sec-filings. 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 |
|---|---|---|---|
| tickers | string | No | Comma-separated ticker symbols, matched as OR (e.g. ARWR,VRTX); omit to skip the filter. |
| form_types | string | No | Comma-separated SEC form types, matched as OR (e.g. 8-K,10-Q); omit to skip the filter. |
| updated_since | string | No | ISO-8601 timestamp; returns only filings synced strictly after it, for incremental polling. |
| date_from | string | No | Inclusive lower bound on the filing date. |
| date_to | string | No | Inclusive upper bound on the filing date. |
| sort | string | No | Default synced_at (default synced_at) Allowed values: synced_at, date_filed |
| order | string | No | Default desc (default desc) Allowed values: asc, desc |
| page | integer | No | Min 1; default 1 (min 1; default 1) Range: 1 to ∞ |
| limit | integer | No | Range 1-500; default 100 (range 1-500; default 100) Range: 1 to 500 |
Example request
curl -H "x-api-key: YOUR_API_KEY" \ "https://app.caelrith.com/api/v1/financials/filings"
Response envelope
Successful responses wrap the payload in a success flag.
{
"success": true,
"data": { /* payload */ },
"meta": { /* pagination, totals */ }
}Catalog version mcp-2026-10-28 · generated from the live MCP catalog