API Documentation — Filing Clarity

Authentication

All API requests require a Bearer token in the Authorization header.

Authorization: Bearer YOUR_API_KEY

Get your API key from your account settings at filingclarity.com/account.

API keys are prefixed with fc_live_. Keep your key secret — it carries your full plan permissions.

Base URL

https://filingclarity.com/api

All responses are JSON. Dates are ISO 8601 (UTC). Monetary values are in USD cents unless noted.

Endpoints

GET /api/filings Included

Returns processed filings for a ticker on your watchlist, with AI-extracted structured data.

Parameters

Name	Type	Required	Description
ticker	string	required	Ticker symbol, e.g. `AAPL`
type	string	optional	Filter by filing type: `8k`, `10q`, `form4`, `13f`
limit	integer	optional	Number of results. Default: 10, max: 50

Example Request

curl -H "Authorization: Bearer fc_live_xxxx" \
  "https://filingclarity.com/api/filings?ticker=AAPL&limit=5"

Example Response

{
  "ticker": "AAPL",
  "company": "Apple Inc.",
  "filings": [
    {
      "filing_type": "10-Q",
      "filed_at": "2026-05-02",
      "period_of_report": "2026-03-31",
      "extracted_data": {
        "revenue_current": 95400000000,
        "revenue_prior": 90400000000,
        "net_income_current": 24100000000,
        "eps_diluted_current": 1.53,
        "going_concern": false
      },
      "edgar_url": "https://www.sec.gov/Archives/edgar/data/320193/..."
    }
  ],
  "retrieved_at": "2026-07-15T14:32:00Z"
}

GET /api/insider Included

Returns Form 4 insider transactions for a ticker on your watchlist.

Parameters

Name	Type	Required	Description
ticker	string	required	Ticker symbol
limit	integer	optional	Default: 10, max: 50

Example Request

curl -H "Authorization: Bearer fc_live_xxxx" \
  "https://filingclarity.com/api/insider?ticker=MSFT"

Example Response

{
  "ticker": "MSFT",
  "transactions": [
    {
      "insider_name": "Satya Nadella",
      "insider_title": "Chief Executive Officer",
      "transaction_date": "2026-07-10",
      "transaction_type": "OPEN_MARKET_SELL",
      "shares_transacted": 50000,
      "price_per_share": 425.50,
      "total_value": 21275000,
      "shares_owned_after": 850000,
      "is_open_market": true,
      "edgar_url": "https://www.sec.gov/..."
    }
  ]
}

GET /api/watchlist Included

Returns your current watchlist with notes and metadata.

Parameters

No parameters required.

Example Request

curl -H "Authorization: Bearer fc_live_xxxx" \
  "https://filingclarity.com/api/watchlist"

Example Response

{
  "watchlist": [
    {
      "ticker": "AAPL",
      "company": "Apple Inc.",
      "cik": "0000320193",
      "added_at": "2026-07-01",
      "notes": "Core position — watching margins"
    }
  ],
  "count": 15,
  "limit": 15,
  "tier": "basic"
}

GET /api/short Included

Returns short interest data for a ticker on your watchlist. Updated on FINRA's bi-monthly schedule (1st and 15th of each month).

Parameters

Name	Type	Required	Description
ticker	string	required	Ticker symbol

Example Request

curl -H "Authorization: Bearer fc_live_xxxx" \
  "https://filingclarity.com/api/short?ticker=NVDA"

Example Response

{
  "ticker": "NVDA",
  "short_interest": [
    {
      "report_date": "2026-07-01",
      "short_interest_shares": 125000000,
      "short_interest_pct_float": 2.8,
      "days_to_cover": 1.2,
      "change_pct": -5.2
    }
  ]
}

Error Codes

Code	Meaning
200	Success
401	Invalid or missing API key
403	Feature not available on your plan
404	Ticker not in your watchlist
429	Rate limit exceeded
500	Server error

Errors return a JSON body: {"error": "message", "code": 401}

Rate Limits

Usage resets at midnight UTC daily. Each response includes a rate limit header:

X-RateLimit-Remaining: 847

Filing Clarity — $299/mo

One plan, all endpoints (including short interest)
10,000 requests/day

Code Examples

Python

import requests

api_key = "fc_live_your_key_here"
headers = {"Authorization": f"Bearer {api_key}"}

# Get recent filings for Apple
response = requests.get(
    "https://filingclarity.com/api/filings",
    headers=headers,
    params={"ticker": "AAPL", "limit": 5}
)
data = response.json()
for filing in data["filings"]:
    print(f"{filing['filing_type']} — {filing['filed_at']}")

JavaScript

const apiKey = 'fc_live_your_key_here';

fetch('https://filingclarity.com/api/filings?ticker=AAPL', {
  headers: { 'Authorization': `Bearer ${apiKey}` }
})
.then(r => r.json())
.then(data => console.log(data.filings));

cURL

# Recent 8-K filings for Tesla
curl -H "Authorization: Bearer fc_live_xxxx" \
  "https://filingclarity.com/api/filings?ticker=TSLA&type=8k&limit=10"

# Your full watchlist
curl -H "Authorization: Bearer fc_live_xxxx" \
  "https://filingclarity.com/api/watchlist"

Filing Clarity API

Authentication

Base URL

Endpoints

Error Codes

Rate Limits

Filing Clarity — $299/mo

Code Examples

Python

JavaScript

cURL

API access is included in the Filing Clarity plan