/api/v1/form-13dSearch and filter parsed 13D/13G ownership filings.
Search and filter parsed 13D/13G ownership filings. Supports filtering by ticker, issuer CIK, filer CIK, filer name, minimum ownership percentage, and form type.
free
Why use this
Retrieve structured beneficial ownership data including percent of class, shares owned, voting power, and stated purpose of transaction.
Common use case
Track activist investors building positions (>5% ownership), monitor large institutional ownership changes, identify takeover or proxy-fight filings, screen for high-conviction positions by ownership threshold.
Parameters
| Name | In | Required | Default | Allowed | Description | Example |
|---|---|---|---|---|---|---|
| query.ticker | body | optional | — | — | Issuer trading symbol (e.g. 'TWTR'). Case-insensitive. | — |
| query.issuerCik | body | optional | — | — | Issuer CIK number. Leading zeros are stripped automatically. | — |
| query.filerCik | body | optional | — | — | Filer (reporting person) CIK. Leading zeros are stripped automatically. | — |
| query.filerName | body | optional | — | — | Partial match on filer name (case-insensitive). E.g. 'Elon Musk'. | — |
| query.minOwnership | body | optional | — | — | Minimum percent of class owned. E.g. 5.0 for >= 5%. | — |
| query.formType | body | optional | — | — | Filter by form type: 'SC 13D', 'SC 13D/A', 'SC 13G', 'SC 13G/A'. Both SC and SCHEDULE variants accepted. | — |
| query.dateRange.from | body | optional | — | — | Start date filter (ISO format, e.g. '2025-01-01'). | — |
| query.dateRange.to | body | optional | — | — | End date filter (ISO format, e.g. '2026-03-14'). | — |
| from | body | optional | 0 | — | Pagination offset. | 2026-01-01 |
| size | body | optional | 50 | — | Page size (max 50). | — |
| sort | body | optional | [{"filedAt":{"order":"desc"}}] | — | Sort specification. Supported fields: filedAt, percentOfClass, sharesOwned. | — |
Response schema
Schema not yet documented
Full response schema, sample response, and curated examples for this endpoint are landing in Phase 59. The hero, parameters, code samples, and metadata above remain accurate today.
Sample response
·
- "status": "success"
- "data":
- "meta":
- "total":
- "from": 0
- "size": 50
Errors
| Status | Label | Description |
|---|---|---|
| 200 | OK | Request succeeded. |
| 400 | Bad Request | Invalid query, body, or path parameter. |
| 401 | Unauthorized | Missing or invalid Authorization header / api_Token. |
| 402 | Payment Required | Insufficient token balance for this call. Top up |
| 429 | Too Many Requests | Rate limit exceeded for your tier (see /pricing for tier limits). Tier limits |
| 500 | Server Error | Unexpected server-side failure. Retry with backoff; report if persistent. |
Code samples
curl -X POST "https://api.finradar.ai/api/v1/form-13d" \
-H "Authorization: Bearer YOUR_JWT_TOKEN"Generate an API key in /account/credentials to run live queries (literal YOUR_API_KEY placeholder shown until then).